xarinit (Create an XAR file)

Format

xarinit -f physical-file-name -n number-of-records [-s record-length]

Function

The xarinit command creates an XAR file within the OpenTP1 file system, and initializes the file to enable use in online mode.

Options

-f physical-file-name~<path name>

Specifies the full path name of the physical file to be created. If you specify the name of a file that already exists, an error results.

-n number-of-records~<unsigned integer> ((1-8192))

Specifies the number of records of the XAR file to be created.

-s record-length~<unsigned integer> (bytes)

Specifies the record length of the XAR file to be created. Specify a multiple of the sector length specified at creation of the OpenTP1 file system by the filmkfs command (an ordinary UNIX file typically has a record length of 512 bytes). If this option is omitted, the sector length of the OpenTP1 file system is used as the record length of the XAR file.

Output messages

Message IDDescriptionOutput destination
KFCA32017-EProcessing could not continue due to insufficient memory in the process-specific area.Standard error output
KFCA32025-EThe specified XAR file path is invalid.Standard error output
KFCA32026-EThe user does not have access rights to the special file.Standard error output
KFCA32027-EThe attempt to open the XAR file exceeded the maximum number of open files allowed by the system.Standard error output
KFCA32028-EAn I/O error occurred while accessing the XAR file.Standard error output
KFCA32029-EProcessing could not continue due to insufficient memory.Standard error output
KFCA32030-EThe system version used for file system creation does not match the system version used to execute the command.Standard error output
KFCA32031-EThe special file to which the XAR file is allocated is not initialized in the OpenTP1 file system.Standard error output
KFCA32032-EThe specified XAR file name is invalid.Standard error output
KFCA32033-EThe specified XAR file already exists.Standard error output
KFCA32034-EThe OpenTP1 file system has insufficient file capacity.Standard error output
KFCA32035-EThe number of files allowed by the OpenTP1 file system has been exceeded.Standard error output
KFCA32037-EThe specified XAR file is being used by another process.Standard error output
KFCA32103-EInvalid usage of the xarinit command.Standard error output
KFCA32106-IHelp messageStandard output
KFCA32107-EInvalid number of records specified.Standard error output
KFCA32108-EThe specified XAR file name is longer than 63 characters.Standard error output
KFCA32162-EInvalid record length specified.Standard error output

Notes