SHOW-JV-ATTRIBUTES

Show attributes of job variable

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-ATTRIBUTES command displays the following attributes of a JV:

Standard information (INFORMATION=*NAME-AND-SIZE):

• name

• length of the JV value

Standard information, all protection attributes and the creation date are displayed (INFORMATION=*ALL) for each job variable specified:

• display “JV-TYPE IS MONJV”, for the duration of the job monitoring

• permitted access mode (standard access control)

• access rights of foreign users (standard access control)

• access rights of the authorized users OWNER, GROUP and OTHERS (if basic ACL was activated)

• names of the guards for read and/or write access (if defined)

• name of the HSMS storage management class (if defined)

• creation date

• creation time (time of day)

• date on which the set retention period elapses

• time relative to the retention period (currently always 00:00:00 hours)

• protection with read password

• protection with write password

Summary line (INFORMATION=*SPACE-SUMMARY) for all specified job variables:

• number of job variables specified

• total length of JV values

Temporary job variables are addressed using the prefixed TEMPFILE character.

Information on special job variables

Special job variables are specified in the form “JV-NAME=$SYSJV.<jvname>”, where the job variable name can contain wildcards. The names of all available special job variables are displayed with JV-NAME=$SYSJV.

With INFORMATION=*ALL-ATTRIBUTES, the format and content of the special job variables are described in an additional output line. The description appears in the currently set job language: English or German (this can be set job-specifically with the /MODIFY-MSG-ATTRIBUTES command).

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

Format

SHOW-JV-ATTRIBUTES                                                                                                 

Alias: SHJVA

JV-NAME = *ALL / <filename 1..54 without-gen-vers with-wild(80)> / *LINK(...)
	*LINK(...)
		|		LINK-NAME = <alphanum-name 1..7>
,INFORMATION = *NAME-AND-SIZE / *ALL-ATTRIBUTES / *SPACE-SUMMARY
,SELECT = *ALL / [*BY-ATTRIBUTES](...)
	[*BY-ATTRIBUTES](...)
		|		ACCESS = *ANY / *READ / *WRITE
		|		,USER-ACCESS = *ANY / list-poss(2): *OWNER-ONLY / *ALL-USERS
		|		,PASSWORD = *ANY / list-poss(3): *NONE / *READ-PASSWORD / *WRITE-PASSWORD
		|		,CREATION-DATE = *ANY / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) /
		|		<date>(...) / *INTERVAL(...)
		|			*TODAY(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			*YESTERDAY(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			<integer -99999..991231>(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			<date>(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			*INTERVAL(...)
		|				|		FROM = 1950-01-01 / <integer -99999..991231>(...) / <date>(...) / *TODAY(...) /
		|				|		*YESTERDAY(...)
		|				|			<integer -99999..991231>(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|			<date>(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|			*TODAY(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|			*YESTERDAY(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|		,TO = *TODAY (...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
		|				|			*TODAY(...)
		|				|				|	TIME = 23:59:59 / <time>
		|				|			*YESTERDAY(...)
		|				|				|	TIME = 23:59:59 / <time>
		|				|			<integer -99999..991231>(...)
		|				|				|	TIME = 23:59:59 / <time>
		|				|			<date>(...)
		|				|				|	TIME = 23:59:59 / <time>
		|		,EXPIRATION-DATE = *ANY / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
		|		<integer -99999..991231>(...) / <date>(...) / *INTERVAL(...)
		|			*TOMORROW(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			*TODAY(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			*YESTERDAY(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			<integer -99999..991231>(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			<date>(...)
		|				|		TIME = *ANY / [*INTERVAL](...)
		|				|			[*INTERVAL](...)
		|				|				|	FROM = 00:00:00 / <time>
		|				|				|	,TO = 23:59:59 / <time>
		|			*INTERVAL(...)
		|				|		FROM = 1950-01-01 / <integer -99999..991231>(...) / *TOMORROW(...) / *TODAY(...) /
		|				|		*YESTERDAY(...) / <date>(...)
		|				|			<integer -99999..991231>(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|			*TOMORROW(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|			*TODAY(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|			*YESTERDAY(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|			<date>(...)
		|				|				|	TIME = 00:00:00 / <time>
		|				|		,TO = *ANY / TODAY(...) / *TOMORROW(...) / *YESTERDAY(...) /
		|				|		<integer -99999..991231>(...) / <date>(...) / *ANY
		|				|			*TODAY(...)
		|				|				|	TIME = 23:59:59 / <time>
		|				|			*TOMORROW(...)
		|				|				|	TIME = 23:59:59 / <time>
		|				|			*YESTERDAY(...)
		|				|				|	TIME = 23:59:59 / <time>
		|				|			<integer -99999..991231>(...)
		|				|				|	TIME = 23:59:59 / <time>
		|				|			<date>(...)
		|				|				|	TIME = 23:59:59 / <time>
		|		,BASIC-ACL = *ANY / *NONE / *YES / [*PARAMETERS](...)
		|			[*PARAMETERS](...)
		|				|		OWNER = *ANY / *NO-ACCESS / [*PARAMETERS](...)
		|				|			[*PARAMETERS](...)
		|				|				|	READ = *ANY / *NO / *YES
		|				|				|	,WRITE = *ANY / *NO / *YES
		|				|		,GROUP = *ANY / *NO-ACCESS / [*PARAMETERS](...)
		|				|			[*PARAMETERS](...)
		|				|				|	READ = *ANY / *NO / *YES
		|				|				|	,WRITE = *ANY / *NO / *YES
		|				|		,OTHERS = *ANY / *NO-ACCESS / [*PARAMETERS](...)
		|				|			[*PARAMETERS](...)
		|				|				|	READ = *ANY / *NO / *YES
		|				|				|	,WRITE = *ANY / *NO / *YES
		|		,GUARDS = *ANY / *YES / *NONE / [*PARAMETERS](...)
		|			[*PARAMETERS](...)
		|				|		READ = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
		|				|		,WRITE = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
		|		,MANAGEMENT-CLASS = *ANY / *NONE / <composed-name 1..8>
		|		,MONJV-PROTECTION = *ANY / *NO / *YES
		|		,CJC-PROTECTION = *ANY / *NO / *YES
		|		,PROTECTION-ACTIVE = *ANY / list-poss(3): *LEVEL-0 / *LEVEL-1 / *LEVEL-2
		|		,SIZE = *ANY / <integer 0..256> / [*INTERVAL](...)
		|			[*INTERVAL](...)
		|				|		FROM = 0 / <integer 0..256>
		|				|		,TO = 256 / <integer 0..256>
,OUTPUT-OPTIONS = [*PARAMETERS] (...)
	[*PARAMETERS](...)
		|		SORT-LIST = *BY-JVNAME / *NO

Operands

JV-NAME = *ALL / <filename 1..54 without-gen-vers with-wild(80)> / *LINK(...)
Specifies the job variable whose attributes are to be displayed.
A job variable may be identified by its name or its link name. Information about job variables of other user IDs is only given if the job variables are shareable or if in the event of activated BASIC-ACL there is at least one access right for the user (GROUP).

JV-NAME = *ALL
The attributes of all the user’s permanent job variables are to be displayed.

JV-NAME = <filename 1..54 without-gen-vers with-wild(80)>
Name of the job variable. The attributes of this job variable are to be displayed. The wildcard character * (asterisk) at the beginning of a name must be entered twice. Nonprivileged users are not allowed to use wildcards within their user ID. If no catalog ID is specified, the default catalog ID of the user ID concerned is selected.

Special JVs can only be referenced in the form “JV-NAME=$SYSJV.<jvname>” where the name can be specified using wildcards. Entry of a catalog ID is not possible. Specifying “$SYSJV.” will cause the names of all available special JVs to be displayed.

JV-NAME = *LINK(...)
The job variable whose attributes are to be displayed is identified by a link name.

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

INFORMATION = *NAME-AND-SIZE / *ALL-ATTRIBUTES / *SPACE-SUMMARY
Attributes to be displayed.

INFORMATION = *NAME-AND-SIZE
Only name and length of the JV value are to be displayed.

INFORMATION = *ALL-ATTRIBUTES
All attributes are to be displayed. In the case of a special JV, however, an output line containing the format and meaning of the variable is output in addition to the name.

INFORMATION = *SPACE-SUMMARY
Only a summary line is required. The summary line contains the number of job variables specified and the total length of their values.

SELECT = *ALL / *BY-ATTRIBUTES(...)
The job variable selection criteria. The following selection criteria are not relevant for displaying special job variables.

SELECT = *ALL
Returns information on all the job variables which the user is authorized to access.

SELECT = *BY-ATTRIBUTES(...)
Restricts the job variables selected from the set specified by JV-NAME to those which satisfy the following specifications. The default value *ANY for an attribute means that the job variable set is not to be restricted to particular values of that attribute.

ACCESS = *ANY / *READ / *WRITE
Returns information on job variables depending on their access type.

ACCESS = *ANY
The ACCESS value is not to be used as a selection criterion.

ACCESS = *READ
Returns information on only those job variables to which writing is prohibited by ACCESS=READ, i.e. to which only read access is permitted.

ACCESS = *WRITE
Returns information on only those job variables to which write access is permitted.

USER-ACCESS = *ANY / list-poss(2): *OWNER-ONLY / *ALL-USERS
Returns information on job variables depending on whether they are shareable. If a user ID other than the user’s own is specified, then implicitly USER-ACCESS=ALL-USERS.

USER-ACCESS = *ANY
The access authorization is not to be used as a selection criterion.

USER-ACCESS = *OWNER-ONLY
Returns information on job variables which only the job variable owner or co-owner may access.

USER-ACCESS = *ALL-USERS
Returns information on job variables which may be also be accessed under other user IDs. 

PASSWORD = *ANY / list-poss(3): *NONE / *READ-PASSWORD / *WRITE-PASSWORD
Returns information on job variables depending on the password protection defined. If several types of password are specified as a list, the system will link them by logical Or, and will return information on all the job variables which satisfy any one of the specified conditions.

PASSWORD = *ANY
Password protection is not to be used as a selection criterion.

PASSWORD = *NONE
Returns information on job variables which have no password protection.

PASSWORD = *READ-PASSWORD
Returns information on job variables which are protected by a read password; the actual passwords will not be output.

PASSWORD = *WRITE-PASSWORD
Returns information on job variables which are protected by a write password; the actual passwords will not be output.

CREATION-DATE = *ANY / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...) / *INTERVAL(...)
Returns information on job variables on the basis of their creation date (CREATION-DATE); range specifications are inclusive of the limit values.

CREATION-DATE = *ANY
The creation date is not to be used as a selection criterion.

CREATION-DATE = *TODAY(...)
Returns information for job variables which have today’s date entered as the CREATION-DATE in their catalog entry.

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified creation date.

TIME = *INTERVAL(...)
Returns information on job variables that were created on the specified day within the specified time interval which follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of creation >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of creation <= the specified time.

CREATION-DATE = *YESTERDAY(...)
Returns information for job variables which have yesterday’s date entered as the CREATION-DATE in their catalog entry.

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified creation date.

TIME = *INTERVAL(...)
Returns information on job variables that were created on the specified day within the specified time interval which follows. 

FROM = 00:00:00 / <time>
Selects job variables for which the time of creation >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of creation <= the specified time.

CREATION-DATE = <integer -99999..991231>(...)
Returns information on job variables which were created on the specified date. Here, the user can specify the creation date in either of two ways:

1. as an absolute date value: (6 digits), a specific date in the form yymmdd (yy = year, mm = month, dd = day)
2. as a relative date value: (6 digits, with preceding sign) the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future; (YESTERDAY corresponds to -1, TODAY corresponds to ±0)

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified creation date.

TIME = *INTERVAL(...)
Returns information on job variables that were created on the specified day within the specified time interval which follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of creation >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of creation <= the specified time.

CREATION-DATE = <date>(...)
Returns information on job variables which were created on the specified date. The user can specify the creation date in the form [yy]yy-mm-dd.

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified creation date.

TIME = *INTERVAL(...)
Returns information on job variables that were created on the specified day within the specified time interval which follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of creation >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of creation <= the specified time.

CREATION-DATE = *INTERVAL(...)
Returns information on job variables which were created within the specified time period. The upper and lower limits are both included in the range specified. See also the explanation of how dates are specified in the EXPIRATION-DATE=<integer ...> operand. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). Whichever of the operands is not specified will be replaced by the default value for use as the limit of the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.

FROM = 1950-01-01 / <integer -99999..991231>(...) / *TODAY(...) / *YESTERDAY(...) / <date>(...)
Returns information on job variables which were created after the specified date (i.e. CREATION-DATE >= specified date).

FROM = <integer -99999..991231>(...)
Returns information on job variables which were created after the specified date (i.e. CREATION-DATE >= specified date).

TIME = 00:00:00 / <time>
Time on the specified date. All job variables created at or after the specified time are selected.

FROM = *TODAY(...)
Returns information on job variables which were created after the specified date (i.e. CREATION-DATE >= current date).

TIME = 00:00:00 / <time>
Time on the specified date. All job variables created at or after the specified time are selected.

FROM = *YESTERDAY(...)
Returns information on job variables which were created after the specified date (i.e. CREATION-DATE >= date of the preceding day).

TIME = 00:00:00 / <time>
Time on the specified date. All job variables created at or after the specified time are selected.

FROM = <date>(...)
Returns information on job variables which were created after the specified date (i.e. CREATION-DATE >= specified date).

TIME = 00:00:00 / <time>
Time on the specified date. All job variables created at or after the specified time are selected.

TO = *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Returns information on job variables which were created before the specified date (i.e. CREATION-DATE <= specified date).

TO = *TODAY(...)
Returns information on job variables which were created before the specified date (i.e. CREATION-DATE <= current date).

TIME = 23:59:59 / <time>
Time on the specified date. All job variables created at or before the specified time are selected.

TO = *YESTERDAY(...)
Returns information on job variables which were created before the specified date (i.e. CREATION-DATE <= date of preceding day).

TIME = 23:59:59 / <time>
Time on the specified date. All job variables created at or before the specified time are selected.

TO = <integer -99999..991231>(...)
Returns information on job variables which were created before the specified date (i.e. CREATION-DATE <= specified date).

TIME = 23:59:59 / <time>
Time on the specified date. All job variables created at or before the specified time are selected.

TO = <date>(...)
Returns information on job variables which were created before the specified date (i.e. CREATION-DATE <= specified date).

TIME = 23:59:59 / <time>
Time on the specified date. All job variables created at or before the specified time are selected.

EXPIRATION-DATE = *ANY / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...) /
<integer -99999..991231>(...) / <date>(...) / *INTERVAL(...)
The EXPIRATION-DATE operand requests information on the job variable as a function of the “expiration date”, i.e. the date from which write accesses to the job variable are allowed. It is meaningful to specify a date in the future if retention periods are being queried.

EXPIRATION-DATE = *ANY
The expiration date (output field EXPIR-DATE) is not to be used as a selection criterion.

EXPIRATION-DATE = *TOMORROW(...)
Returns information on job variables which have tomorrow’s date entered as the EXPIRATION-DATE in their catalog entry.

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TIME = *INTERVAL(...)
Returns information on job variables for which the expiration date lies within the specified interval that follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of expiration >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of expiration <= the specified time.

EXPIRATION-DATE = *TODAY(...)
Returns information on job variables which have today’s date entered as the EXPIRATION-DATE in their catalog entry.

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TIME = *INTERVAL(...)
Returns information on job variables for which the expiration date lies within the specified interval that follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of expiration >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of expiration <= the specified time.

EXPIRATION-DATE = *YESTERDAY(...)
Returns information on job variables which have yesterday’s date entered as the EXPIRATION-DATE in their catalog entry.

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TIME = *INTERVAL(...)
Returns information on job variables for which the expiration date lies within the specified interval that follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of expiration >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of expiration <= the specified time.

EXPIRATION-DATE = <integer -99999..991231>(...)
Here, the user can specify the expiration date in either of two ways:

1. as an absolute date value: (6 digits), a specific date in the form yymmdd (yy = year, mm = month, dd = day)
2. as a relative date value: (6 digits with preceding sign), the number of days from today’s date, in the form -n for dates in the past, and +n for dates in the future; (YESTERDAY corresponds to -1, TODAY corresponds to ±0, TOMORROW corresponds to +1)

TIME = *ANY / *INTERVAL(...)

Restricts the selection of job variables to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TIME = *INTERVAL(...)
Returns information on job variables for which the expiration date lies within the specified interval that follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of expiration >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of expiration <= the specified time.

EXPIRATION-DATE = <date>(...)
Returns information on job variables for which exactly the specified date is entered as the EXPIRATION-DATE in the catalog entry. The user can specify the expiration date in the form [yy]yy-mm-dd.

TIME = *ANY / *INTERVAL(...)
Restricts the selection of job variables to a time interval related to the specified expiration date. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TIME = *INTERVAL(...)
Returns information on job variables for which the expiration date lies within the specified interval that follows.

FROM = 00:00:00 / <time>
Selects job variables for which the time of expiration >= the specified time.

TO = 23:59:59 / <time>
Selects job variables for which the time of expiration <= the specified time.

EXPIRATION-DATE = *INTERVAL(...)
Returns information on only the job variables whose expiration dates lie within the period specified as the operand value, i.e. job variables whose retention period expires during the specified period. The upper and lower limits are both included in the range specified. See also the explanation of how dates are specified in the EXPIRATION-DATE=<integer ...> operand. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). Whichever of the operands is not specified will be replaced by the default value for use as the limit of the range. The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit.

FROM = 1950-01-01 / <integer -99999..991231>(...) / <date>(...) / *TOMORROW(...) / *TODAY(...) / *YESTERDAY(...)
Returns information on job variables for which the EXPIRATION-DATE >= the specified date.

FROM = <integer -99999..991231>(...)
Returns information on job variables for which the EXPIRATION-DATE >= the specified date.

TIME = 00:00:00 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

FROM = <date>(...)
Returns information on job variables for which the EXPIRATION-DATE >= the specified date.

TIME = 00:00:00 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

FROM = TOMORROW(...)
Returns information on job variables for which the EXPIRATION-DATE >= date of the next day.

TIME = 00:00:00 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

FROM = *TODAY(...)
Returns information on job variables for which the EXPIRATION-DATE >= date of the current day.

TIME = 00:00:00 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

FROM = *YESTERDAY(...)
Returns information on job variables for which the EXPIRATION-DATE >= date of the preceding day.

TIME = 00:00:00 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE after the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TO = *ANY / *TODAY(...) / *TOMORROW(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...)
Returns information on job variables for which the EXPIRATION-DATE <= the specified date.

TO = *ANY
Specifies an open interval that starts with the EXPIRATION-DATE but has no upper limit.

TO = *TODAY(...)
Returns information on job variables for which the EXPIRATION-DATE <= date of the current day.

TIME = 23:59:59 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TO = *TOMORROW(...)
Returns information on job variables for which the EXPIRATION-DATE <= date of the next day.

TIME = 23:59:59 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TO = *YESTERDAY(...)
Returns information on job variables for which the EXPIRATION-DATE <= date of the preceding day.

TIME = 23:59:59 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TO = <integer -99999..991231>(...)
Returns information on job variables for which the EXPIRATION-DATE <= the specified date.

TIME = 23:59:59 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

TO = <date>(...)
Returns information on job variables for which the EXPIRATION-DATE <= the specified date.

TIME = 23:59:59 / <time>
Time on the specified date. All job variables that have an EXPIRATION-DATE before the specified time are selected. Note that the time stamp for the EXPIRATION-DATE is always set to 00:00:00 at present!

BASIC-ACL = *ANY / *NONE / *YES / *PARAMETERS(...)
Selects all job variables whose BASIC-ACL entry matches the specified values.

BASIC-ACL = *NONE
Returns information on job variables that have no BASIC-ACL entry in the catalog.

BASIC-ACL = *YES
Returns information on job variables that have a BASIC-ACL entry in the catalog.

BASIC-ACL = *PARAMETERS(...)
Selects all job variables for which the specified access rights are defined in the BASIC-ACL entry. NO-ACCESS means that no access rights have been defined.

OWNER = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights must already be defined for the owner.

OWNER = *PARAMETERS(...)
Access rights that must be present for the owner (logically ORed together):

READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.

WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.

GROUP = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights should already be defined for the owner’s user group.

GROUP = *PARAMETERS(...)
Access rights that must be present for the owner’s user group (logically ORed together):

READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.

WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.

OTHERS = *ANY / *NO-ACCESS / *PARAMETERS(...)
Specifies which access rights should already be defined for all other users.

OTHERS = *PARAMETERS(...)
Access rights that must be present for all other users (logically ORed together):

READ = *ANY / *NO / *YES
Specifies whether read access authorization must be present.

WRITE = *ANY / *NO / *YES
Specifies whether write access authorization must be present.

GUARDS = *ANY / *NONE / *YES / *PARAMETERS(...)
Returns information on job variables for which access is controlled using GUARDS (see the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command).

GUARDS = *ANY
Access control with GUARDS is not to be used as a selection criterion.

GUARDS = *NONE
Returns information on job variables that are not protected by GUARDS against unauthorized access.

GUARDS = *YES
Returns information on job variables that are protected by GUARDS against unauthorized access, i.e. job variables for which access is controlled via the GUARDS subsystem. 

GUARDS = *PARAMETERS(...)
Returns information on job variables which are protected by GUARDS against unauthorized access as specified, i.e. job variables for which access control is implemented using GUARDS: Access to the job variable is controlled by a guard, i.e. a special object which contains all the conditions under which a user is granted access authorization (e.g. date, time, user ID). The GUARDS function unit of the chargeable software product SECOS (see the “SECOS” manual [35]) must be installed in order to create and maintain a guard.
Each access mode can be controlled by a separate guard. If no guard (*NONE) is defined for a given access mode, no corresponding access is permitted. If a defined guard is not accessible, the mode of access protected by it is not permitted. If the GUARDS subsystem is not available at the time of accessing the job variable, no access of any kind is allowed for the job variable.

READ = *ANY / *NONE / <filename 1..18 without-cat-gen-vers> 
Returns information on job variables which are protected against unauthorized read access by the specified “guard”. The default value *ANY means that the selection of job variables is not based on read protection with a guard. *NONE selects job variables for which no read guard was defined, i.e. job variables for which no read access is permitted.

WRITE = *ANY / *NONE / <filename 1..18 without-cat-gen-vers>
Returns information on job variables which are protected against unauthorized write access by the specified “guard”. The default value *ANY means that the selection of job variables is not based on a guard. *NONE selects job variables for which no guard was defined, i.e. job variables for which no write access is permitted.

MANAGEMENT-CLASS = *ANY / *NONE / <composed-name 1..8>
Returns information on job variables assigned the specified HSMS management class.

MANAGEMENT-CLASS = *ANY
The HSMS management class is not a selection criterion.

MANAGEMENT-CLASS = *NONE
Returns information only on job variables with no HSMS management class assigned to them.

MANAGEMENT-CLASS = <composed-name 1..8>
Returns information on job variables assigned the specified HSMS management class.

MONJV-PROTECTION = *ANY / *NO / *YES
Returns information about job variables regarding their use as job monitoring job variables.

MONJV-PROTECTION = *ANY
Use as job monitoring job variables is not a selection criteria.

MONJV-PROTECTION = *NO
Returns information about job variables that are not monitoring jobs.

MONJV-PROTECTION = *YES
Returns information about job variables that are monitoring jobs (see also output field "JV-TYPE IS MONJV").

CJC-PROTECTION = *ANY / *NO / *YES
Returns information about job variables regarding their use in CJC functions.

CJC-PROTECTION = *ANY
Use in CJC functions is not a selection criteria.

CJC-PROTECTION = *NO
Returns information about job variables that are not used in CJC functions.

CJC-PROTECTION = *YES
Returns information about job variables that are used in CJC functions

PROTECTION-ACTIVE = *ANY / list-poss(3): *LEVEL-0 / *LEVEL-1 / *LEVEL-2
Returns information on job variables for which the specified protection level is the highest activated access control.
When the job variable is accessed, the highest activated protection level applies. The following table shows the method used for access control, the protection attributes, and the job variable protection hierarchy (protection levels):

Access control method	Protection attribute	Prot. level
Standard access control	ACCESS and USER-ACCESS	0
Basic access control list	BASIC-ACL	1
Access control via guards	PASSWORD	2

Table 124: Hierarchy of access control methods

All other protection attributes of the job variable (e.g. passwords) are evaluated independently, without regard to the implemented protection level.

PROTECTION-ACTIVE = *ANY
The access control method is not to be used as a selection criterion.

PROTECTION-ACTIVE = *LEVEL-0
Returns information on job variables for which access is controlled via standard access control.

PROTECTION-ACTIVE = *LEVEL-1
Returns information on job variables for which access is controlled via a basic access control list (BASIC-ACL protection)

PROTECTION-ACTIVE = *LEVEL-2
Returns information on job variables for which access is controlled via an access control list (ACL) or by GUARDS.

SIZE =* ANY / <integer 0..256> / *INTERVAL(...)
Requests information on job variables depending on the length of their value.

SIZE = *ANY
The length of the value of job variable is not to be used as a selection criterion.

SIZE = <integer 0..256>
Returns information on job variables with the specified length of the value. 

SIZE = *INTERVAL(...)
Returns information on job variables for which the length of the value lies within the specified range. The upper and lower limits are both included in the range specified. It is also possible to specify limits using only the operand FROM (lower limit) or TO (upper limit). For whichever operand is not specified, the default value will be used as the limit for the range.
The use of range limits for information output can only be meaningful if the chosen lower limit <= the upper limit. Information will only be returned about job variables for which the length of the value is at least equal to the FROM value and at most equal to the TO value (FROM <= SIZE <= TO).

FROM = 0 / <integer 0..256>
Returns information only about those job variables for which the length of the value is at least the specified number (SIZE >= specified value).

TO = 256 / <integer 0..256>
Returns information only about those job variables for which the length of the value is at most the specified number (SIZE <= specified value).

OUTPUT-OPTIONS = *PARAMETERS(...) 
Controls the information output.

SORT-LIST = *BY-JVNAME / *NO
Determines how the catalog entries/path names are sorted in the display.

SORT-LIST = *BY-JVNAME
The catalog entries/path names are sorted alphabetically.

SORT-LIST = *NO
The catalog entries/path names are displayed in the order in which they are contained in the catalog.

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 fields

With INFORMATION=*NAME-AND-SIZE set (default value), only the header line containing the length of the JV value and the JV’s path name is output. If INFORMATION =*ALL is specified, the JV’s attributes are output in addition to the header line. At the end of the output there is a summary line indicating the number of JVs included in the output and the total length of their JV values. 

Header line

<jv-length> <pathname>
n	-	numeric character
a	-	alphanumeric character

Output field	Format	Meaning
<jv-length>	nnnnnnn	7-digit number; indicates how many bytes the JV value occupies (length)
<pathname>	:aaaa:	indicates the catalog ID of the file catalog in which the JV is stored
	$userid.	max. 8-character user ID for the JV
	jvname	name of the permanent or temporary JV about which information is to be output

Table 125: Output fields in the SHOW-JV-ATTRIBUTES header line

Summary line

Output field	Format	Meaning
SUM	nnnnn	6-digit number; indicates the number of JVs included in the output
JV-VALUE	nnnnnnnn	8-digit number; total length (in bytes) of all JV values included in the output

Table 126: Output fields in the SHOW-JV-ATTRIBUTES summary line

Output field	Values	Description
ACCESS	WRITE	Read and write access to the JV is allowed
	READ	Only read access is allowed to the JV, write access is not allowed
CRE-DATE	yyyy-mm-dd	yyyy = year; mm = month; dd = day; date JV created or date of last modification
CRE-TIME	hh:mm:ss	hh = hours; mm = minutes; ss = seconds; time JV created or time of last modification of the JV
EXPIR-DATE	yyyy-mm-dd	yyyy = year; mm = month; dd = day; date until which the JV is locked against write accesses; i.e., the JV cannot be modified or deleted
EXPIR-TIME	hh:mm:ss	hh = hours; mm = minutes ; ss = seconds; time relative to EXPIR-DATE, currently always 00:00:00
GROUP		Only if BASIC-ACL protection is defined Access rights assigned for the user class “GROUP”
	R W	Read and write access
	- -	No access rights
	a a	Combination of the characters RW- permitted
GUARD-READ	guardname	Only if GUARDS protection is defined Name of a GUARD that controls read access
	NONE	No read access is allowed
GUARD-WRIT	guardname	Only if GUARDS protection is defined Name of a GUARD that controls write access
	NONE	No write access is allowed
JV-TYPE IS MONJV		Displayed as the first line of the JV attributes if the JV is monitoring a job (write protection during job monitoring)
MAN-CLASS	hsms-class	Name of the HSMS storage management class (only if defined)
OWNER		Only if BASIC-ACL protection is defined The access authorizations specified for the “OWNER” class of users (owner of the JV)
	R W	Read and write access
	- -	No access rights
	a a	Combination of the characters RW- permitted
OTHERS		Only if BASIC-ACL protection is defined The access authorizations specified for the “OTHERS” class of users.
	R W	Read and write access
	- -	No access rights
	a a	Combination of the characters RW- permitted
READ-PASS	NONE	No read password has been defined for the JV
	YES	A read password has been defined for the JV, i.e. read access is possible only by entering the password
USER-ACC	OWNER-ONLY	The JV cannot be accessed by other user IDs
	ALL-USERS	The JV can be accessed by other user IDs
WRITE-PASS	NONE	No write password has been defined for the JV
	YES	A write password has been defined for the JV, i.e. write access is possible only by entering the password

Table 127: JV attributes output fields of the SHOW-JV-ATTRIBUTES command

Output in S variables

The INFORMATION operand identifies the S variables which are to be created. The possible values for INFORMATION are *NAME-AND-SIZE and *ALL-ATTRIBUTES (in table: INF=ALL). No variables are output for special job variables.

Output information	Name of the S variable	T	Contents	Condition
JV access method *READ = read access *WRITE = write access (with implicit read access)	var(*LIST).ACCESS	S	*READ *WRITE	INF=ALL
BASIC-ACL protection active	var(*LIST).B-ACL.ACTIVE	B	FALSE TRUE	INF=ALL
GROUP read permission (BASIC-ACL)	var(*LIST).B-ACL.GROUP.READ	S	’’ *NO *YES	INF=ALL
GROUP write permission (BASIC-ACL)	var(*LIST).B-ACL.GROUP.WRITE	S	’’ *NO *YES	INF=ALL
OTHERS read permission (BASIC-ACL)	var(*LIST).B-ACL.OTHERS.READ	S	’’ *NO *YES	INF=ALL
OTHERS write permission (BASIC-ACL)	var(*LIST).B-ACL.OTHERS.WRITE	S	’’ *NO *YES	INF=ALL
OWNER read permission (BASIC-ACL)	var(*LIST).B-ACL.OWNER.READ	S	’’ *NO *YES	INF=ALL
OWNER write permission (BASIC-ACL)	var(*LIST).B-ACL.OWNER.WRITE	S	’’ *NO *YES	INF=ALL
Catalog ID of the job variable	var(*LIST).CAT-ID	S	<cat-id 1...4>
Job variable creation date	var(*LIST).CRE-DATE	S	<yyyy-mm-dd>	INF=ALL
Job variable creation time	var(*LIST).CRE-TIME	S	<hh:mm:ss>	INF=ALL
Job variable expiration date	var(*LIST).EXPIR-DATE	S	<yyyy-mm-dd>	INF=ALL
Job variable expiration time	var(*LIST).EXPIR-TIME	S	00:00:00	INF=ALL
Access control by means of guards	var(*LIST).GUARD-ACTIVE	B	FALSE TRUE	INF=ALL
Name of the guard for read protection	var(*LIST).GUARD.READ	S	’’ <filename 1...18>	INF=ALL
Name of the guard for write protection	var(*LIST).GUARD.WRITE	S	’’ <filename 1...18>	INF=ALL
Job variable path name	var(*LIST).JV-NAME	S	<filename 1...54>
Length of the job variable value	var(*LIST).JV-SIZE	I	<integer>
Data type of the job variables; if necessary, displays a particular use *MONJV=job monitoring job variable *BOOLEAN/*INTEGER=reserved for use by the system and do not appear for user job variables	var(*LIST).JV-TYPE	S	’’ *BOOLEAN *INTEGER *MONJV	INF=ALL
Name of the HSMS storage management class	var(*LIST).MANAGE-CLASS	S	’’ <name 1...8>	INF=ALL
Job variable read password	var(*LIST).READ-PASS	S	*NONE *YES	INF=ALL
Name of the job variable.	var(*LIST).SHORT-JV-NAME	S	<filename 1...41>
Users with access permission	var(*LIST).USER-ACCESS	S	*ALL-USER *OWNER-ONLY	INF=ALL
User ID of the job variable	var(*LIST).USER-ID	S	<name 1...8>
Job variable write password	var(*LIST).WRITE-PASS	S	*NONE *YES	INF=ALL

Examples

Output to SYSOUT

/show-jv-attr —————————————————————————————————————————————————————————— (1)

%0000035 :4V05:$USER1.DAT
%0000009 :4V05:$USER1.MONA
%0000128 :4V05:$USER1.MONB
%0000128 :4V05:$USER1.MONC
%0000000 :4V05:$USER1.PROBE
%SUM   000005 JV'S; JV-VALUE = 00000300 BYTES   

/sh-jv-attr jv=mon*,inf=all-attr ——————————————————————————————————————— (2)

%0000009 :4V05:$USER1.MONA
% USER-ACC   = OWNER-ONLY  ACCESS     = WRITE
% CRE-DATE   = 2014-02-04  EXPIR-DATE = 2014-02-04
% CRE-TIME   =   15:55:41  EXPIR-TIME =   00:00:00
% READ-PASS  = NONE
% WRITE-PASS = NONE
%0000128 :4V05:$USER1.MONB
% USER-ACC   = OWNER-ONLY  ACCESS     = WRITE
% CRE-DATE   = 2014-02-04  EXPIR-DATE = 2014-02-04
% CRE-TIME   =   15:55:04  EXPIR-TIME =   00:00:00
% READ-PASS  = NONE
% WRITE-PASS = NONE
%0000128 :4V05:$USER1.MONC
% JV-TYPE IS MONJV
% USER-ACC   = OWNER-ONLY  ACCESS     = WRITE
% CRE-DATE   = 2014-02-04  EXPIR-DATE = 2014-02-04
% CRE-TIME   =   15:55:42  EXPIR-TIME =   00:00:00
% READ-PASS  = NONE
% WRITE-PASS = NONE
%SUM   000003 JV'S; JV-VALUE = 00000265 BYTES

/show-jv-attr jv=mon*,select=*by-attr(monjv=*yes),inf=*all-attr ———————— (3) 

%0000128 :4V05:$USER1.MONC
% JV-TYPE IS MONJV
% USER-ACC   = OWNER-ONLY  ACCESS     = WRITE
% CRE-DATE   = 2014-02-04  EXPIR-DATE = 2014-02-04
% CRE-TIME   =   15:55:42  EXPIR-TIME =   00:00:00
% READ-PASS  = NONE
% WRITE-PASS = NONE
%SUM   000003 JV'S; JV-VALUE = 00000265 BYTES

/show-jv-attr select=*by-attr(basic-acl=*yes),inf=*all-attr———————————— (4)

%0000035 :4V05:$USER1.DAT
% USER-ACC   = OWNER-ONLY  ACCESS     = WRITE
% OWNER      = R W         GROUP      = - -         OTHERS     = - -
% CRE-DATE   = 2014-02-06  EXPIR-DATE = 2014-02-06
% CRE-TIME   =   15:58:18  EXPIR-TIME =   00:00:00
% READ-PASS  = NONE
% WRITE-PASS = NONE
%SUM   000001 JV'S; JV-VALUE = 00000035 BYTES      

(1)	Display all job variables of the user ID.
(2)	Display catalog entries of job variables with names beginning with “MON*”. The job variable MONJV.JOB1 is currently monitoring a job.
(3)	Display the catalog entry of the job variables which have names beginning with “MON” and which are currently monitoring a job. This is the job variable MONC.
(4)	Display the job variables of the user ID which is protected with a BASIC-ACL. In this case, this is only the job variable with the name DAT.

Output in S variables

/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd (show-jv-attr jv=hugo,inf=*all-attr),text-output=*none,
           structure-output=var
/show-var var,inf=*par(val=*c-literal,list-index=*yes)

OUT1#1.JV-NAME = ':2OSG:$USER1.HUGO'
OUT1#1.CAT-ID = '2OSG'
OUT1#1.USER-ID = 'USER1'
OUT1#1.SHORT-JV-NAME = 'HUGO'
OUT1#1.JV-SIZE = 27
OUT1#1.JV-TYPE = ''
OUT1#1.USER-ACCESS = '*OWNER-ONLY'
OUT1#1.ACCESS = '*WRITE'
OUT1#1.READ-PASS = '*NONE'
OUT1#1.WRITE-PASS = '*NONE'
OUT1#1.B-ACL.ACTIVE = FALSE
OUT1#1.B-ACL.OWNER.READ = ''
OUT1#1.B-ACL.OWNER.WRITE = ''
OUT1#1.B-ACL.GROUP.READ = ''
OUT1#1.B-ACL.GROUP.WRITE = ''
OUT1#1.B-ACL.OTHERS.READ = ''
OUT1#1.B-ACL.OTHERS.WRITE = ''
OUT1#1.EXPIR-DATE = '2014-01-07'
OUT1#1.EXPIR-TIME = '00:00:00'
OUT1#1.CRE-DATE = '2014-01-07'
OUT1#1.CRE-TIME = '16:46:33'
OUT1#1.GUARD-ACTIVE = FALSE
OUT1#1.GUARD.READ = ''
OUT1#1.GUARD.WRITE = ''
OUT1#1.MANAGE-CLASS = ''
*END-OF-VAR
*END-OF-CMD

/exec-cmd (show-jv-attr jv=mona,inf=*name-and-size),text-output=*none,
           structure-output=var
/show-var var,inf=*par(val=*c-literal,list-index=*yes)

VAR1#1.JV-NAME = ':2OSG:$USER1.MONA'
VAR1#1.CAT-ID = '2OSG'
VAR1#1.USER-ID = 'USER1'
VAR1#1.SHORT-JV-NAME = 'MONA'
VAR1#1.JV-SIZE = 9
*END-OF-VAR
*END-OF-CMD