Show contents of job variable
Component: | JV |
Functional area: | Job variables |
Domain: | JOB-VARIABLES |
Privileges: | STD-PROCESSING |
Routing code: | J |
This function is only available to the user if the chargeable software product JV has been loaded as a subsystem.
Function
The SHOW-JV command displays the contents of a user or special job variable. Special job variables are special JVs managed by the system. They can be queried under the dummy user ID SYSJV. The command SHOW-JV-ATTRIBUTES JV-ID=JV-NAME=$SYSJV. can be used to output the names of the available special job variables
Format
SHOW-JV | Alias: SHJV | ||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||
Operands
JV-CONTENTS = <filename 1..54 without-gen-vers> / *SUBSTRING(...) / *LINK(...)
Specifies the job variable contents that to be output.
A JV can be identified by its name or by its link name, and optionally a particular part of the contents can be specified.
JV-CONTENTS = <filename 1..54 without-gen-vers>
Name of the JV. The contents of the entire JV are displayed.
JV-CONTENTS = *SUBSTRING(...)
The contents of the area identified by POSITION and LENGTH are displayed. If POSITION and LENGTH are not specified, the contents of the entire JV are displayed.
JV-NAME = <filename 1..54 without-gen>
Name of the JV.
POSITION = 1 / <integer 1..256>
Position within the JV at which output is to begin. The command is rejected if the character at the specified position is undefined.
LENGTH = *REST / <integer 1..256>
Number of characters to be displayed. The sum of the numeric values specified in the POSITION and LENGTH operands must not exceed 257. A warning is output if the substring designated by POSITION and LENGTH is not fully defined.
LENGTH = *REST
The length of the value starting from the position specified in the POSITION operand applies.
JV-CONTENTS = *LINK(...)
The JV is identified by a link name. If POSITION and LENGTH are not specified, the contents of the entire JV are displayed, otherwise the contents of the specified area.
LINK-NAME = <alphanum-name 1..7>
Link name of the JV.
POSITION = 1 / <integer 1..256>
Position within the JV at which output is to begin. The command is rejected if the character at the specified position is undefined.
LENGTH = *REST / <integer 1..256>
Number of characters to be displayed.
The sum of the numeric values specified in the POSITION and LENGTH operands must not exceed 257. A warning is output if the substring designated by POSITION and LENGTH is not fully defined.
LENGTH = *REST
The length of the value starting from the position specified in the POSITION operand applies.
OUTPUT-FORMAT =
Determines the output format.
OUTPUT-FORMAT = *CHARACTER
Output in character format.
OUTPUT-FORMAT = *HEXADECIMAL
Output in hexadecimal format.
PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET
Read password of the JV. The PASSWORD operand has the following special characteristics:
The input field is automatically blanked out in the guided dialog.
In unguided dialog and foreground procedures, the entry *SECRET or ^, SDF provides a blanked out input field for inputting the password.
The password entered is not logged.
PASSWORD = *NONE
The JV has no password or the password was already specified in the ADD-PASSWORD command.
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 | 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 |
Output in S variable
Output information | Name of the S variable | T | Content |
|---|---|---|---|
Content of the job variable | var(*LIST).JV-VALUE | S | <c-string 0..511> |
Example
/show-jv jv-contents=$sysjv.datum ————————————————————————————————— (1)
%27.01.2012
/show-jv jv=test1,output-format=*char
%Heute ist Dienstag der 27.01.2012 ——————————————————————————————————— (2)
/show-jv jv=test1,output-format=*hex
%C885A4A3854089A2A340C4898595A2A381874084859940F2F74BF0F14BF2F0F1F2 ——— (3)
/show-jv jv-contents=(jv-name=test1,position=24) ——————————————————— (4)
%27.01.2012
(1) | Display current date (special JV for date in German $SYSJV.DATUM). |
(2) | Display contents of job variable TEST1 in character format (= Today is Tuesday, 24.01.2009). |
(3) | Display contents of job variable TEST1 in hexadecimal format. |
(4) | Display contents of job variable TEST1 in character form, starting at byte 24. |