Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Display conditional job control information

Component:	JV
Functional area:	Job variables
Domain:	JOB-VARIABLES
Privileges:	STD-PROCESSING OPERATING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION
Routing code:	E

This function is available to the user only if the chargeable software product JV has been loaded as a subsystem.

Function

The SHOW-CJC-STATUS command displays information about jobs that are currently using CJC (conditional job control) functions.
The query may be limited to the user’s own processor, but may also be extended to include any or all processors in an existing multiprocessor network. When queries concern “foreign” processors, only information about jobs using job variables belonging to the user’s processor is displayed. Nonprivileged users are only supplied with information about jobs running under their own user ID.
Furthermore, it is possible to limit the information to one or more job variables, identified by name. In this case, only those jobs are shown that have functions in which the job variables named occur in conditional expressions.

The following information can be output:

number of jobs, number of user IDs, referenced catalogs (INFORMATION = *SUMMARY).
job numbers of the jobs, user IDs (listed under TSOS only), referenced catalogs (INFORMATION = *USER-LIST).

The command supports structured output in S variables (see "Output in S variables").

Privileged functions

Systems support staff (TSOS user ID or OPERATING privilege) are supplied with information about all jobs.

Format

SHOW-CJC-STATUS

HOST = OWN / ALL / FOREIGN / CATALOG(...) /
list-poss(25): <c-string 1..8> / <filename 1..54 without-gen>
	*CATALOG(...)
		\|	CATALOG-ID = list-poss(25): <c-string 1..4> / <filename 1..54 without-gen>
,JV-NAME = *ALL / list-poss(25): <filename 1..54 without-gen> / <partial-filename 2..53>
,INFORMATION = SUMMARY / USER-LIST

Operands

HOST =
Processor or catalog IDs to which the query refers. Non-local processors may be specified only if the software product HIPLEX MSCF is installed (see the “HIPLEX MSCF” manual [25]).
With non-local processors, jobs are taken into account only if in CJC functions they use at least one job variable not cataloged in the local processor.

HOST = *OWN
Local processor.

HOST = *ALL
All processors in the MSCF network.

HOST = *FOREIGN
All processors in the MSCF network, with the exception of the local processor.

HOST = *CATALOG(...)
Catalog ID, specified in the following.

CATALOG-ID = list-poss(25): <c-string 1..4> / <filename 1..54 without-gen>
Catalog ID of the processor to which the query refers, or name of a JV whose value denotes the catalog ID (left-justified, no following characters or blanks).

HOST = list-poss(25): <c-string 1..8> / <filename 1..54 without-gen>
BCAM name (left-justified with no trailing characters or blanks) of the processor in the MSCF network to which the query refers, or name of a JV whose value denotes the BCAM name of a processor. If a list is specified, BCAM and job variable names may not be mixed.

JV-NAME = *ALL / list-poss(25): <filename 1..54 without-gen> / <partial-filename 2..53>
JVs to which the query refers.
Default: All JVs.
Only jobs using one of the specified JVs in CJC functions are taken into account. The argument “JV-NAME=:cat1:”, for example, refers to all jobs which use JVs cataloged on pubset cat1 in CJC functions.
Special job variables must not be specified.

INFORMATION = *SUMMARY / *USER-LIST
Type of information to be displayed.

INFORMATION = *SUMMARY
For each processor:

local catalogs of the processor
number of jobs
number of user IDs
referenced catalogs (slave processors of a shared pubset obtain, if required, information on a catalog which is not available locally)

INFORMATION = *USER-LIST
For each processor:

local catalogs of the processor
task sequence number (TSN) of the jobs
user IDs (under TSOS only)
referenced catalogs (slave processors of a shared pubset obtain, if required, information on a catalog which is not available locally)

Return codes

SC1	Maincode	Meaning
0	CMD0001	Command executed
1	CMD0202	Buffer overflow or output not possible, syntax error
32	CMD2009	Error during S variable generation
32	CMD0221	Internal error
130	CJC0070	No access to other processors because MSCF is not active

Output in S variables

The INFORMATION operand identifies the S variables which are to be created. The possible values for INFORMATION are *SUMMARY and *USER-LIST.

Output information	Name of the S variable	T	Contents	Condition
Name of the host	var(*LIST).HOST	S	*LOC <host-name>	INF=SUM/ USER-LIST
Local catalog IDs of the host	var(LIST).LOC-CAT-ID(LIST)	S	<cat-id>	INF=SUM/ USER-LIST
Number of jobs; on error (RESULT=*ERROR) NUM-OF-TSN is set to -1.	var(*LIST).NUM-OF-TSN	I	-1 <integer>	INF=*SUM
Number of user IDs; on error (RESULT=*ERROR) NUM-OF-USER is set to -1.	var(*LIST).NUM-OF-USER	I	-1 <integer>	INF=*SUM
Referenced catalogs	var(LIST).REF-CAT-ID(LIST)	S	'' <cat-id>	INF=*SUM
Result of the query	var(*LIST).RESULT	S	ERROR NO-CJC *NO-ERROR	INF=SUM/ USER-LIST
Catalogs referenced for the job	var(LIST).TASK(LIST).REF-CAT-ID(*LIST)	S	'' <cat-id>	INF=*USER- LIST
TSN of the job currently using the CJC function; on error (RESULT=ERROR) TASK(LIST).TSN is set to ''.	var(LIST).TASK(LIST).TSN	S	'' *NO-TASK <tsn>	INF=*USER- LIST
User ID under which the job is running; on error (RESULT= ERROR) TASK(LIST).USER-ID is set to ''.	var(LIST).TASK(LIST).USER-ID	S	'' *NO-USER <user-id>	INF=*USER- LIST

Example (privileged user)

/show-cjc

 HOST    !CAT.LOC.             ! # TASKS  # USERS  CAT.REF.
------------------------------------------------------------------------
 *LOC    !1STZ                 !       4        2  1STZ

/show-cjc inf=*user-list

 HOST    !CAT.LOC.             ! TSN      USER     CAT.REF.
------------------------------------------------------------------------
 *LOC    !1STZ                 ! 042M     TSOS     1STZ
         !                     ! 05BT     FT       1STZ
         !                     ! 05BP     FT       1STZ
         !                     ! 042P     TSOS     1STZ

Example (S variable output)

/declare-var var-name=var(type=struc),multiple-elem=*list /exec-cmd (show-cjc-status inf=*summary),text-output=*none,struc-output=var /show-var var,inf=*par(val=*c-literal)

VAR(*LIST).HOST = '*LOC'
VAR(*LIST).LOC-CAT-ID(*LIST) = '1SBZ'
VAR(*LIST).RESULT = '*NO-ERROR'
VAR(*LIST).NUM-OF-TSN = 2
VAR(*LIST).NUM-OF-USER = 1
VAR(*LIST).REF-CAT-ID(*LIST) = '1SBZ'

/exec-cmd (show-cjc-status inf=*user-list),text-output=*none,struc-output=var /show-var var,inf=*par(val=*c-literal)

VAR(*LIST).HOST = '*LOC'
VAR(*LIST).LOC-CAT-ID(*LIST) = '1SBZ'
VAR(*LIST).RESULT = '*NO-ERROR'
VAR(*LIST).TASK(*LIST).TSN = '08NB'
VAR(*LIST).TASK(*LIST).USER-ID = 'TSOS'
VAR(*LIST).TASK(*LIST).REF-CAT-ID(*LIST) = '1SBZ'
VAR(*LIST).TASK(*LIST).TSN = '08ND'
VAR(*LIST).TASK(*LIST).USER-ID = 'TSOS'
VAR(*LIST).TASK(*LIST).REF-CAT-ID(*LIST) = '1SBZ'

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-CJC-STATUS