READ-IOCF

Read IOCF

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

Function

The systems support staff can read an IOCF from the hard disk of the service computer and write it into a PAM file on a BS2000 disk. A list of the IOCFs on the hard disk of the service computer can be obtained using the SHOW-IOCF command. An IOCF can be written from a PAM file onto the hard disk of the service computer using the WRITE-IOCF command.

Format

READ-IOCF                                                                                                                                                 

FILE-NAME = <filename 1..54>

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

Operands

FILE-NAME = <filename 1..54>
Name of the BS2000 file into which the IOCF is to be written. An existing file of the same name will be overwritten.

LEVEL = *ACTIVE
The current IOCF is being read.

LEVEL = <integer 0..9>
Level number of the IOCF which is to be read. The value range covers all existing levels. If the level number given is invalid, then the command is rejected.
The maximum number of levels is hardware-dependent. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	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	No authorization