SHOW-XCS-OCCUPATION Show occupation information for TU tasks using XCS

Description status: Functional area: Domain: Privileges:	MSCF V21.0A Pubset and MRSCAT management MULTI-CATALOG-AND-PUBSET-MGMT TSOS OPERATING
Routing code:	@

Function

The SHOW-XCS-OCCUPATION command provides information on the TU tasks which are currently using global XCS-wide locks on the local host system. Up to 130 tasks can be shown. If information is available for more than that number of tasks, output breaks off after 130 tasks and an appropriate warning is issued.
The TU tasks for which information is supplied make use of XCS functionality and therefore have to be terminated if HIPLEX MSCF is terminated on the local host. Thus if HIPLEX MSCF is terminated or aborted, the associated tasks are aborted.
If this is not possible, HIPLEX MSCF cannot be terminated. The command then indicates which tasks are affected and thus enables systems support staff to take appropriate action.

The command supports structured output in S variables.

Format

SHOW-XCS-OCCUPATION

OUTPUT = *SYSOUT / *SYSLST(...)
	*SYSLST(...)
		|	SYSLST-NUMBER = *STD / <integer 1..99>

Operands

OUTPUT = *SYSOUT / *SYSLST(...)
Specifies where the information is to be output.

OUTPUT = *SYSOUT
The information is output to the system file SYSOUT.

OUTPUT = *SYSLST(...)
The information is output to the system file SYSLST.

SYSLST-NUMBER = *STD / <integer 1..99>
Specifies whether the information is to be output to the system file SYSLST or to a SYSLST file from the set SYSLST01 through SYSLST99.
The default is *STD, i.e. output is directed to the system file SYSLST.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed without error
2	0	CMD0002	Warning, output incomplete
	1	CMD2202	Syntax error
	32	CMD0221	Internal error (system error)
	32	CMD2009	Error on OPS variable output
	64	CMD0216	User does not have required privilege
	64	MCS1019	No XCS network defined
	128	MCS1020	Not enough space

Output format

Assuming that 34 tasks are using XCS, the following information is output to SYSOUT:

/SHOW-XCS-OCCUPATION OUTPUT=*SYSOUT
SHOW-XCS-OCCUPATION 
-----------------------------------------------------------------------------
NUMBER OF TASKS USING XCS: 34
LOCAL TASKS USING XCS:
 0T01  0T02  0T03  0T04  0T05  0T06  0T07  0T08  0T09  0T10  0T11  0T12  0T13
 0T14  0T15  0T16  0T17  0T18  0T19  0T20  0T21  0T22  0T23  0T24  0T25  0T26
 0T27  0T28  0T29  0T30  0T31  0T32  0T33  0T34
-----------------------------------------------------------------------------
SHOW-XCS-OCCUPATION                                            END OF DISPLAY

Key to the output

Output field	Meaning / Information
NUMBER OF TASKS  USING XCS:	Number of tasks currently using XCS; numeric, 1 - 10 bytes long.
LOCAL TASKS USING XCS:	TSNs of the tasks currently using XCS List of TSNs, alphanumeric, 4 bytes long; breaks off after 130th task.

Table 7: Output values for SHOW-XCS-OCCUPATION command

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Number of tasks currently using the XCS	var(*LIST).NUMB-OF-TASKS	I	<integer 0..2147483647>
TSNs of the tasks currently using the XCS (output is terminated after 130 TSNs)	var(*LIST).TSN-OF-TASKS	S	<alphan.-name 1..4>	Number of tasks > 0