SHOW-IOCF

Show information on IOCF

Component:	IOCFCOPY
Functional area:	System control and optimization
Domain:	SYSTEM-MANAGEMENT
Privileges:	TSOS OPERATING
Routing code:	@

Function

With the SHOW-IOCF command, systems support staff can obtain information on the active IOCF (of the active session) and on all IOCFs on the hard disk of the service processor. Information output can be directed to SYSOUT or to SYSLST.

This command can also be entered on an operator terminal. Output is then always takes place asynchronously and in block mode on the operator terminal.

Format

SHOW-IOCF                                                                                                                                               

LEVEL-NAME = *ALL / *ACTIVE / <integer 0..9>

,OUTPUT = *SYSOUT / *SYSLST

Operands

LEVEL = *ALL
Information is output for the active IOCF and for all other existing IOCFs (including the level numbers).

LEVEL = *ACTIVE
Information is output for the active IOCF.

If the level cannot be accessed because only one bus configuration is specified, *** BUS CONFIGURATION WITHOUT IOCF *** is displayed.

LEVEL = <integer 0..9>
The level number of the IOCF on which information is to be output. The value range covers all available levels. If the level number does not exist, the command is rejected.

The maximum number of levels is hardware-dependent.

• If there is no level number, the command is rejected.

• If the level is empty (e.g. when newly created) or if the files cannot be evaluated, *** INVALID DATA OR EMPTY LEVEL *** is displayed.

• If the level cannot be accessed, *** INFORMATION NOT AVAILABLE *** is displayed.

OUTPUT = *SYSOUT
Information output is directed to SYSOUT.

OUTPUT = *SYSLST
Information output is directed to SYSLST. In the case of entry on an operator terminal, this specification is changed to OUTPUT=*SYSOUT (command return code IOF0127).

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without errors
2	0	IOF0114	Specified IOCF is empty
2	0	IOF0125	Bus configuration, no IOCF available
2	0	IOF0127	Parameter OUTPUT changed to SYSOUT as SYSLST is not possible on the operator terminal
	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	System 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 has no authorization

Format of the output

LEVEL xxx:  hh:mm yy.ddd zzzzz BLOCKS
<comment>

where

xxx	Level number 1 to 9 or ACT (active IOCF)
hh:mm	Generation time
yy.ddd	Generation year and generation day (Julian date)
zzzzz	Number of 256-byte blocks in the IOCF
<comment>	64-byte long comment, taken unchanged from the IOCF. Contains, among other things, the 8-byte long name of the IOCF.

Example

Information on active IOCF

/show-iocf level=*active

%LEVEL ACT:   21:20  14.278   189 BLOCKS 
%        S1900006 / TESTSYSTEM             / 05.10.2014