Modify job monitoring JV
Component: | JV |
Functional area: | Job variables |
Domain: | JOB-VARIABLES |
Privileges: | STD-PROCESSING |
This function is available to the user only if the chargeable software product JV has been loaded as a subsystem.
Function
The following elements in the system section of a job monitoring job variable can be modified with the MODIFY-MONJV command:
Time stamp (operand TIMESTAMP)
Name of the job to be monitored (operand DESCRIPTOR)
Job-specific information (operand USER-INFORMATION)
The format and position of the elements in the system section are described in the “JV” manual [20].
The caller must have write privileges.
When no job variable is specified, the command affects the monitoring job variable of the job from which the command was issued.
The command is only executed when the job variable monitors a job.
Format
MODIFY-MONJV | Alias: MDMJV |
MONJV = *SMONJVJ / <filename 1..54 without-gen-vers> ,TIMESTAMP = *UNCHANGED / *SET ,DESCRIPTOR = *UNCHANGED / <c-string 1..8 with-low> ,USER-INFORMATION = *UNCHANGED / <c-string 1..58 with-low> ,PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET | |
Operands
MONJV = *SMONJVJ / <filename 1..54 without-gen-vers>
Name of the monitoring job variable. The default value is *SMONJVJ, i.e. the job variable that monitors its own job (it was linked to the *SMONJVJ link name when the job was started, i.e. when the status was set to “$R”).
TIMESTAMP = *UNCHANGED / *SET
Specifies if a time stamp (in GMT time) is to be set for job monitoring
(format: yyyy-mm-ddhhmmss). The default value is *UNCHANGED, i.e. a new time stamp is not set.
DESCRIPTOR = *UNCHANGED / <c-string 1..8 with-low>
Specifies if the name of the application to be monitored is to be set. The default value is *UNCHANGED, i.e. no change is made. Right-justified input containing less than eight characters is padded with spaces.
USER-INFORMATION = *UNCHANGED / <c-string 1..58 with-low>
Specifies if application-specific information is to be set. The default value is *UNCHANGED, i.e. no change is made. Right-justified input containing less than 58 characters is padded with spaces.
PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer-2147483648..2147483647> / *SECRET
Password that may be required for write access to the job variable. The default value is *NONE, i.e. no password.
The PASSWORD operand has the following special characteristics:
The input field is automatically blanked out in an interactive dialog.
In unguided dialog and foreground procedures, the entry *SECRET or ^ permits concealed input of the password.
The password entered is not logged.
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 |
Example
/set-logon-par user,12345678,'PASSWORD',monjv=test/show-jv test
%$R 09WXU1OSH J0312012-01-27102849
/mod-monjv test,timestamp=*set,desc='APPLICTN',user-inf='User Info' ——— (1)/show-jv test ————————————————————————————————————————————————————————————— (2)
%$R 09WXU1OSH J0312012-01-271028492012-01-27103438APPLICTN User Info
(1) | A time stamp is set in the job variable TEST, the DESCRIPTOR and USER-INFORMATION fields are supplied with any value you choose. |
(2) | The job variable TEST now contains the following values:
|