WRITE-IOCF

Write IOCF

Component:	IOCFCOPY
Functional area:	System control and optimization
Domain:	SYSTEM-MANAGEMENT
Privileges:	TSOS

Function

Systems support can write an IOCF which is stored as a PAM file on a BS2000 disk to the hard disk of the service system with the WRITE-IOCF command.

The input file has to be available in the form of a PAM file. The system checks whether the file contains an IOCF. If the IOCF does not suit the system type the write job is rejected with the message IOF0126.

The command cannot be issued on an VM2000 guest system.

The SHOW-IOCF command provides information on existing IOCFs. An IOCF can be written from the hard disk of the service system to a PAM file with the READ-IOCF command.

Format

WRITE-IOCF                                                                                                                                                 

FILE-NAME = <filename 1..54>

,LEVEL = 0 / <integer 0..9>

Operands

FILE = <filename 1..54>
Name of the BS2000 file.

LEVEL = 0 / <integer 0..9>
Level number of the IOCF to be written. The value range covers all existing ranges. The active IOCF cannot be overwritten.
The maximum number of levels is hardware-dependent. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Specified IOCF is empty
2	0	IOF0125	Bus configuration, no IOCF
	1	CMD2201	Parameter error: At least one value from the command call is incorrect (e.g. file does not exist, incorrect format or incorrect file contents, level number does not exist, etc.). The exact cause of the error is contained in a preceding message.
	32	CMD0221	Internal error: A system interface which was called reports an error. The exact cause of the error is contained in a preceding message.
	64	CMD0216	User does not have authorization
	64	IOF0119	Function not possible in the current HSI or not permitted.