SHOW-JV-LINK

Display job variable names and associated link names

Component:	JV
Functional area:	Job variables
Domain:	JOB-VARIABLES
Privileges:	STD-PROCESSING HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION
Routing code:	$ (with NBCONOPI=N) or J (with NBCONOPI=Y)

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

Function

The SHOW-JV-LINK command is used to output job variable names and their associated link names to SYSOUT. The SET-JV-LINK command is used to assign a link name to a job variable. This assignment is entered into the JV-LINK table of the job.

Notes

• “Structure Implicit” notation is guaranteed for the LINK-NAME operand, i.e. SHOW-JV-LINK LINK-NAME=jvlink.

• A JV link name is always linked uniquely with one job variable name, whereas a JV name may be connected to more than one link name. A JV-LINK entry may also exist for a job variable which has been deleted after creation of the JV-LINK entry.

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

Format

SHOW-JV-LINK                                                                                                            

Alias: SHJVL

JV-NAME = *ALL / <filename 1..54 without-gen-vers with-wild(80)> / *LINK(...)
	*LINK(...)
		|	LINK-NAME = <alphanum-name 1..7>

Operands

JV-NAME = *ALL / <filename 1..54 without-gen-vers with-wild(80)> / *LINK(...)
Specifies the job variable for which the JV-LINK tables entries are to be displayed. A job variable may be identified by its name or its link name.

JV-NAME = *ALL
The entire JV-LINK table is to be displayed.

JV-NAME = <filename 1..54 without-gen-vers with-wild(80)>
Name of the JV whose JV-LINK entries are to be output. The wildcard character * (asterisk) at the beginning of a name must be entered twice.

JV-NAME = *LINK(...)
The JV for which the JV-LINK entries are to be displayed is identified by its link name.

LINK-NAME = <alphanum-name 1..7>
Link name of the JV.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed
1	0	CMD0001	No action necessary
2	0	CMD0001	Command executed with a warning
	1	CMD0202	Syntax error
	32	CMD2009	Error during S variable generation
	32	CMD0221	System error
	64	JVS04E0	Command not executable in the call environment; if possible, remove cause of error (see SYSOUT message JVS04xx)
	130	JVS04E1	Command cannot be executed at this time; for cause see SYSOUT message JVS04xx
	130	CMD2282	Subsystem JV not available for indefinite time

Meaning of the output columns

The JV-LINK entry information is output in table form, sorted alphabetically in order of link name.

Output column	Meaning
LINK-NAME	Link name of the JV, preceded by an asterisk
JV-NAME	Path name of the associated JV

Table 128: Output columns of the SHOW-JV-LINK command

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Name of the job variable	var(*LIST).JV-NAME	S	<filename 1...54>
Link name of the job variable	var(*LIST).LINK-NAME	S	*<alphan.-name 1...7>

Example

/set-jv-link link-name=hilfe,jv-name=mon.abc
/set-jv-link link-name=prog1,jv-name=edi.1
/set-jv-link link-name=prog2,jv-name=edi.2 ———————————————————————————— (1)
/show-jv-link link-name=hilfe ————————————————————————————————————————— (2)

% LINK-NAME  JV-NAME
% *HILFE     :1OSN:$USER1.MON.ABC 

/show-jv-link jv-name=edi. ———————————————————————————————————————————— (3)

% LINK-NAME  JV-NAME
% *PROG1     :1OSN:$USER1.EDI.1
% *PROG2     :1OSN:$USER1.EDI.2

(1)	Allocating various link names to job variables
(2)	Outputting the JV-LINK entry for the link name HELP
(3)	Outputting the JV-LINK entries of job variables with names beginning with “EDI.”.