COZZI-Create IFS Stream File (CRTSTMF)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The COZZI-Create IFS Stream File (CRTSTMF) command creates an empty ASCII text file on the IFS and sets its CCSID to the CCSID specified on this command.

Top

Parameters

Keyword Description Choices Notes
STMF New IFS Stream File name Path name Required, Positional 1
PATH IFS file location (directory) Path name, *STMF, *HOME Optional, Positional 2
CCSID Stream File CCSID Integer, 819, *ASCII, *UTF8, *EBCDIC, *JOB Optional, Positional 3
Top

New IFS File name (STMF)

Specifies the IFS file name to be created. If the file already exists, no action is taken. Otherwise, the file is created as a Text file with the CCSID specified on the CCSID parameter of this command.

This is a required parameter.

ifs-file-namee
Specify the name of the IFS file to be created. Optionally, if PATH(*STMF) is specified, you may include the fully qualified path name in front of the name of the file being created. This file name is The STMF parameter value is combined with the PATH parameter value to identify the file that is created.
Top

IFS Stream file location (PATH)

Specifies an optional path name where the STMF (stream file) is created.

*STMF
No path name is specified. The Streamfile name specified on the STMF parameter is used for the Stream File name and location. NOTE: if no path name is specified on either parameter, the file is created in the current working directory.
*HOME
The *HOME special value indicates that the Home Directory of the User running the command is where the STMF is created. If the user has no home directory associated with their User Profile, the directory named /home/user-profile is used.
path-name
Specify the path name where the STMF is to be created.
Top

CCSID to assing to the file (CCSID)

Specifies the CCSID for the file being created.

819
The file is created as a PC ASCII file with CCSID(819).
*ASCII
The file is created as a PC ASCII file with CCSID(819).
*UTF8
The file is created as a PC ASCII file with CCSID(1208).
*EBCDIC
The file is created as an EBCDIC file with CCSID(37).
*JOB
The file is created as an EBCDIC file with a CCSID equal to the the CCSID assigned to the job running the CRTSTMF command.
integer
Specify an valid CCSID between 0 and 65535. The special value CCSID(0) is the same as specifying CCSID(*JOB).
Top

Examples for CRTSTMF

Example 1: Simple Command Example

CRTSTMF  STMF('NOTES.TXT')

This command creates the ASCII file named NOTES.TXT in the user's HOME directory. The CCSID will default to the PC ASCII CCSID which is 819.

Example 2: More Complex Command Example

CRTSTMF  STMF('LOG.TXT')  PATH('/HOME/COZTOOLS') CCSID(*UTF8)

This command creates the file named LOG.TXT in the path name /HOME/COZTOOLS and assigns it CCSID(1208) which is UTF-8.

Example 3: Alternative PATH Example

CRTSTMF  STMF('/PICKLES/LOG.TXT') PATH(*NONE)

This command creates the file named LOG.TXT in the /PICKLES directory. The special PATH value PATH(*NONE) indicates that no path is specified on the PATH parameter and the STMF alone is to be used to identify where the file is created.

Top

Error messages for CRTSTMF

*ESCAPE Messages

CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9807
One or more libraries in library list deleted.
CPF9808
Cannot allocate one or more libraries on library list.
CPF9810
Library &1 not found.
CPF9811
Program &1 in library &2 not found.
CPF9812
File &1 in library &2 not found.
CPF9820
Not authorized to use library &1.
CPF9830
Cannot assign library &1.
CPF9899
Error occurred during processing of command.
Top