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.

Parameters

Keyword	Description	Choices	Notes
STMF	New IFS Stream File name	Path name	Required, Positional 1
CCSID	Stream File CCSID	1-65533, 819, *ASCII, *UTF8, *EBCDIC, *JOB	Optional, Positional 2

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-name

Specify the name of the IFS file to be created. If the file name is qualified, it is created in the specified directory. If it is unqualified, it creates the file in the job's current directory. If the current directory is the default the file is created in the user's home folder.

CCSID to assigned 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). Which is the North American EBCDIC CCSID.

*JOB

The file is created as an EBCDIC file with a CCSID equal to the CCSID assigned to the job running the CRTSTMF command.

integer

Specify a valid CCSID between 0 and 65535. The special value CCSID(0) is the same as specifying CCSID(*JOB).

Examples for CRTSTMF

Example 1: Simple Command Example

CRTSTMF  STMF('NOTES.TXT')

This command creates the ASCII file named NOTES.TXT in the job's current direcotory. The CCSID will default to the PC ASCII CCSID which is 819.

Example 2: More Complex Command Example

CRTSTMF  STMF('/home/iquery/logs/mylog.txt') CCSID(*UTF8)

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

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.