Delete job variable
Component: | JV |
Functional area: | Job variables |
Domain: | JOB-VARIABLES |
Privileges: | STD-PROCESSING |
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 DELETE-JV command is used to delete job variables cataloged under the user’s own ID. Job variables that monitor a job (SET-LOGON-PARAMETERS, ENTER-JOB, ENTER-PROCEDURE) cannot be deleted until the job is completed (status indicator: $T or $A) or unless job monitoring is prematurely terminated with the MODIFY-JV-ATTRIBUTES command (MONJV-PROTECTION operand).
Job variables that are used in conditional job control (CJC) commands and macros are likewise protected against deletion (information can be obtained with the SHOW-CJC-STATUS command), i.e. a condition formulated in the ADD-CJC-ACTION or WAIT-EVENT commands or in the ONEVT macro continues to apply.
Privileged functions
The privileged functions for systems support (TSOS privilege) include specification of temporary or cataloged files of any user ID, the ability to ignore protection attributes of the job variable being deleted and, in the case of a user ID change, to branch to guided dialog.
By default, systems support (TSOS privilege) is a co-owner of all the job variables (and can, therefore, delete job variables under any user ID). When SECOS is used, this co-ownership can be restricted for permanent job variables.
Format
DELETE-JV | Alias: DLJV | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
JV-NAME = <filename 1..54 without-gen-vers with-wild(80)> / *LINK(...)
Specification identifying the job variable to be deleted. JVs to be deleted can be identified by name or link name.
If the JV is protected by a password, the password must be specified (in the ADD-PASSWORD command). The password with the higher protection function should always be specified (write before read password).
JV-NAME = <filename 1..54 without-gen-vers with-wild(80)>
Name of the JV to be deleted. Nonprivileged users may only specify their own user ID without using wildcards. If no catalog ID is specified, the default catalog ID of the user ID concerned is selected. If the first character in the string is “*”, then it has to be entered twice.
JV-NAME = *LINK(...)
The JV to be deleted is identified by a link name.
LINK-NAME = <alphanum-name 1..7>
Link name of the JV to be deleted.
The JV to be deleted must be cataloged under the user’s own ID.
IGNORE-PROTECTION = *NONE / list-poss(4): *ACCESS / *EXPIRATION-DATE / *READ-PASSWORD / *WRITE-PASSWORD
Specifies which protection attributes are to be ignored during deletion of a JV. The *ACCESS entry also applies to BASIC-ACL and GUARDS protection.
Only systems support (TSOS privilege) can delete JVs by entering the operand values *READ-PASSWORD and *WRITE-PASSWORD without entering the password.
PASSWORDS-TO-IGNORE = *NONE / *SECRET / list-poss(3): <x-string 1..8> / <c-string 1..4> /
<integer -2147483648..2147483647>
Allows the deletion of job variables that are protected by the specified passwords (write before read password). No entry is made in the password table.
The 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.
DIALOG-CONTROL =
Specifies whether and under what conditions a verification dialog is to be conducted with the user during the deletion process. Verification is advisable if the job variable name is partially qualified or specified with wildcards, thus enabling more than one job variable to be deleted (also unintentionally).
The verification dialog mechanism is available only in interactive mode, though that does include procedures.
Each verification query can be answered with response [,CHECK=mode].
Answer | Effects | |
|---|---|---|
Y | The JV or JV set displayed in the query is to be deleted. | |
N | The JV or JV set displayed is not to be deleted. | |
T | The verification dialog is aborted. The job variables concerned are not deleted. | |
Other values | Same effect as "N" | |
Optional suffix: | Effects | |
,CHECK=mode | CHECK enables the setting for the verification dialog to be changed (corresponds to DIALOG-CONTROL). The following values can be specified for <mode>: | |
SINGLE | : corresponds to DIALOG-CONTROL=*JV-CHANGE | |
MULTIPLE | : corresponds to DIALOG-CONTROL=*USER-ID-CHANGE | |
PVS | : corresponds to DIALOG-CONTROL=*CATALOG-CHANGE | |
NO | : corresponds to DIALOG-CONTROL=*NO | |
STD | : corresponds to DIALOG-CONTROL=*STD | |
DIALOG-CONTROL = *STD
Default value: corresponds to *USER-ID-CHANGE in true interactive mode and to *NO in procedures and in batch mode.
DIALOG-CONTROL = *NO
All selected job variables are deleted without a verification dialog.
DIALOG-CONTROL = *JV-CHANGE
A verification query occurs for each job variable to be deleted (message JVS0469).
DIALOG-CONTROL = *USER-ID-CHANGE
A verification query occurs in each case for all job variables under one user ID that are to be deleted (message JVS0465). The query does not occur if only one job variable is to be deleted.
DIALOG-CONTROL = *CATALOG-CHANGE
A verification query occurs in each case for all job variables of a pubset that are to be deleted (message JVS0468). The query does not occur if only one job variable is to be deleted.
OPTION = *ALL / *DATA
Specifies whether the job variable entry or only the contents are to be deleted.
OUTPUT = *NO / *SYSOUT
Specifies whether the names of the deleted job variables are to be output.
SUPPRESS-ERRORS = *NONE / list-poss(3): <alphanum-name 7..7>
In procedures, the user can specify whether the spin-off mechanism or SDF-P error handling is to be triggered every time an error occurs (apart from syntax errors), or whether specific error conditions are to be ignored.
SUPPRESS-ERRORS = *NONE
All errors will trigger the spin-off mechanism or SDF-P error handling.
SUPPRESS-ERRORS = list-poss(3): <alphanum-name 7..7>
The user can define which errors are to be ignored by means of their DMS error codes (alphanum-name 7..7). If the specified error occurs, the spin-off mechanism will not be triggered. A maximum of 3 error codes may be specified. DMS error code: 7 characters, of which the first three are always “DMS”; the last 4 characters identify the error; the digits 0..9 and letters A..F are permitted. When error codes are entered, no check is made to verify that valid error codes have been specified.
A detailed list of valid JVS error codes can be found in the “JV” manual [20] or on the manual server (URL: http://manuals.ts.fujitsu.com ) by means of an HTML application and on the “BS2000 SoftBooks” DVD.
SELECT = *ALL / *BY-ATTRIBUTES(...)
The job variable selection criteria. The following selection criteria are not relevant for displaying special job variables.
SELECT = *ALL
Deletes 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
Deletes job variables depending on the permitted access type.
ACCESS = *READ
Deletes only those job variables for which write access is prohibited by
ACCESS=READ, i.e. to which only read access is permitted.
ACCESS = *WRITE
Deletes only those job variables for which write access is permitted.
USER-ACCESS = *ANY / list-poss(2): *OWNER-ONLY / *ALL-USERS
Deletes 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 = *OWNER-ONLY
Deletes job variables which only the owner or co-owner may access.
USER-ACCESS = *ALL-USERS
Deletes job variables which may also be accessed under other user IDs.
PASSWORD = *ANY / list-poss(3): *NONE / *READ-PASSWORD / *WRITE-PASSWORD
Deletes 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 = *NONE
Deletes job variables which have no password protection.
PASSWORD = *READ-PASSWORD
Deletes job variables which are protected by a read password.
PASSWORD = *WRITE-PASSWORD
Deletes job variables which are protected by a write password
CREATION-DATE = *ANY / *TODAY(...) / *YESTERDAY(...) / <integer -99999..991231>(...) / <date>(...) /
*INTERVAL(...)
Deletes job variables on the basis of their creation date (CREATION-DATE); range specifications are inclusive of the specified limit values. It is meaningless to specify a CREATION-DATE which lies in the future!
CREATION-DATE = *TODAY(...)
Deletes 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(...)
Deletes job variables that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of creation >= the specified time.
CREATION-DATE = *YESTERDAY(...)
Deletes 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(...)
Deletes job variables that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of creation >= the specified time.
CREATION-DATE = <integer -99999..991231>(...)
Deletes job variables which were created on the specified date. Here, the user can specify the creation date in either of two ways:
as an absolute date value: (6 digits), a specific date in the form yymmdd (yy = year, mm = month, dd = day)
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(...)
Deletes job variables that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of creation >= the specified time.
CREATION-DATE = <date>(...)
Deletes 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(...)
Deletes job variables that were created on the specified day within the specified time interval which follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of creation >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of creation >= the specified time.
CREATION-DATE = *INTERVAL(...)
Deletes 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>(...)
Deletes job variables which were created after the specified date (i.e. CREATION-DATE >= specified date).
FROM = <integer -99999..991231>(...)
Deletes 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(...)
Deletes 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(...)
Deletes job variables which were created after the specified date (i.e. CREATION-DATE >= date of 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>(...)
Deletes 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>(...)
Deletes job variables which were created before the specified date (i.e. CREATION-DATE <= specified date).
TO = *TODAY(...)
Deletes 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(...)
Deletes 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>(...)
Deletes 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>(...)
Deletes 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 deletes job variables as a function of the “expiration date” (EXPIR-DATE output field), 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 = *TOMORROW(...)
Deletes 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(...)
Deletes job variables for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of expiration <= the specified time.
EXPIRATION-DATE = *TODAY(...)
Deletes only 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(...)
Deletes job variables for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of expiration <= the specified time.
EXPIRATION-DATE = *YESTERDAY(...)
Deletes only 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(...)
Deletes job variables for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Deletes 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:
as an absolute date value: (6 digits), a specific date in the form yymmdd (yy = year, mm = month, dd = day)
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(...)
Deletes job variables for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of expiration <= the specified time.
EXPIRATION-DATE = <date>(...)
Deletes 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(...)
Deletes job variables for which the expiration date lies within the specified interval that follows.
FROM = 00:00:00 / <time>
Deletes job variables for which the time of expiration >= the specified time.
TO = 23:59:59 / <time>
Deletes job variables for which the time of expiration <= the specified time.
EXPIRATION-DATE = *INTERVAL(...)
Deletes only job variables whose expiration dates lie within the period specified below, i.e. files whose retention period expires after 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(...)
Deletes job variables for which the EXPIRATION-DATE >= the specified date.
FROM = <integer -99999..991231>(...)
Deletes 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>(...)
Deletes 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(...)
Deletes 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(...)
Deletes 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(...)
Deletes 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>(...)
Deletes 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(...)
Deletes 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(...)
Deletes 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(...)
Deletes 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>(...)
Deletes 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>(...)
Deletes 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(...)
Deletes job variables whose BASIC-ACL entry matches the specified values.
BASIC-ACL = *NONE
Deletes job variables that have no BASIC-ACL entry in the catalog.
BASIC-ACL = *YES
Deletes job variables that have a BASIC-ACL entry in the catalog.
BASIC-ACL = *PARAMETERS(...)
Deletes 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.
Access rights specified with the OWNER, GROUP and OTHERS operands within the *PARAMETERS(...) structure are logically ORed.
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(...)
Deletes job variables for which access is controlled using GUARDS (see the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command).
GUARDS = *NONE
Deletes job variables that are not protected by GUARDS against unauthorized access.
GUARDS = *YES
Deletes job variables that are protected by GUARDS against unauthorized access, i.e. for which access is controlled via GUARDS.
GUARDS = *PARAMETERS(...)
Deletes 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>
Deletes 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>
Deletes 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>
Deletes job variables assigned the specified HSMS management class.
MANAGEMENT-CLASS = *NONE
Deletes job variables with no HSMS management class assigned to them
MANAGEMENT-CLASS = <composed-name 1..8>
Deletes job variables assigned the specified HSMS management class.
PROTECTION-ACTIVE = *ANY / list-poss(3): *LEVEL-0 / *LEVEL-1 / *LEVEL-2
Deletes 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 |
All other protection attributes of the job variable (e.g. passwords) are evaluated independently, without regard to the implemented protection level.
PROTECTION-ACTIVE = *LEVEL-0
Deletes job variables for which access is controlled via standard access control.
PROTECTION-ACTIVE = *LEVEL-1
Deletes job variables for which access is controlled via a basic access control list (BASIC-ACL protection)
PROTECTION-ACTIVE = *LEVEL-2
Deletes job variables which are accessed via GUARDS.
SIZE =* ANY / <integer 0..256> / *INTERVAL(...)
Requests information on job variables depending on the length of their value.
SIZE = <integer 0..256>
Deletes job variables whose value is the specified number of bytes in length.
SIZE = *INTERVAL(...)
Deletes job variables for which the length of the job variable value lies within the specified range. The upper and lower limits are both included in the range specified. See also the explanation of the operand SIZE = <integer> 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>
Deletes job variables for which the length of the value is at least the specified number of bytes (SIZE >= specified value).
TO = 256 / <integer 0..256>
Deletes job variables for which the length of the value is at most the specified number of bytes (SIZE <= specified value).
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 |