Set default values for monitoring disks
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | D |
Function
This command sets volume-specific default values for the allocation of private disks in the DMS use mode for:
automatic allocation by the system (ASSIGN-TIME operand)
the use mode of the disk with respect to other systems (SYSTEM-ALLOCATION operand)
permitting allocation requests from users (USER-ALLOCATION operand)
requesting allocation permission via the operator (OPERATOR-CONTROL operand).
No default values can be set with this command for public disks and for private disks in the SPECIAL use mode (special applications such as VOLIN).
Format
SET-DISK-PARAMETER | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Operands
UNIT =
Specifies one or more private disks for which default values are to be set.
UNIT = *VOLUME(...)
Specifies the volume serial number of one or more private disks for which default values are to be set.
VOLUME = list-poss(10): <vsn 1..6>
Specifies one or more volume serial numbers (VSNs). Up to 10 VSNs can be listed.
UNIT = list-poss(10): <alphanum-name 2..2> / <alphanum-name 4..4>
Specifies the mnemonic device name of one or more private disks for which defaults are to be set. A maximum of 10 private disks may be specified.
DEFAULT =
Specifies whether the defined default values (see the SET-DISK-DEFAULT command) are to be set for the ASSIGN-TIME, USER-ALLOCATION and OPERATOR-CONTROL parameters and whether the system presetting (=*ALL) is to be set for the SYSTEM-ALLOCATION parameter.
DEFAULT = *NO
The parameters described above are not changed to the default values.
DEFAULT = *YES
The parameters described above are changed into the default values.
TYPE =
Specifies the device type of the disk units to be used for the disks defined in the UNIT operand.
Specification of an explicit device type is only permitted if the disk is not allocated or as long as no MOUNT message has been received for the appropriate disk (TYPE=*FROM-USER or *FROM-DEVICE is accepted at any time). Specification of an explicit device type for a disk specified by its mnemonic device name is rejected. The original presetting is *FROM-DEVICE.
TYPE = *UNCHANGED
The value valid up to now (previous SET-DISK or presetting) remains unchanged.
TYPE = *FROM-DEVICE
The device type is defined either by mounting the volume on a device or by a user request for a volume which has not yet been mounted (MOUNT message). A user’s request for the disk is rejected if the device type specified does not match the disk already mounted.
TYPE = *FROM-USER
The device administration uses the device type specified in the user’s request.
TYPE = <device>
Explicit specification of the device type. A mount request from a user in which a different device type is specified is rejected.
Only device types known within the system are accepted. In interactive mode, the possible device types are displayed with TYPE=?.
The possible specifications are given in the device table in section "Device types for DMS tape processing" (device type column).
SYSTEM-ALLOCATION =
Specifies the use mode of the disk for the system in relation to other systems.
SYSTEM-ALLOCATION = *UNCHANGED
The value valid up to now (previous SET-DISK or system presetting) remains unchanged.
SYSTEM-ALLOCATION = *EXCLUSIVE
The disk can only be allocated by excluding other systems.
ASSIGN-TIME =
Defines the time for allocation and release of a private disk which is to be used for DMS. The system presetting is *STD.
ASSIGN-TIME = *UNCHANGED
The value valid up to now (previous SET-DISK or presetting) remains unchanged.
ASSIGN-TIME = *STD
The value set with the SET-DISK-DEFAULTS command is valid.
ASSIGN-TIME = *USER
The time is defined as the first request or the last return of disk allocation by the user.
ASSIGN-TIME = *OPERATOR
The private disk is allocated independently of a user request from the time the disk is mounted and recognized as being online. The disk is allocated until ASSIGN-TIME=*USER is set.
USER-ALLOCATION =
Defines default values for disk allocation by tasks according to the allocation types task exclusive and task-shareable. The system presetting is *STD.
USER-ALLOCATION = *UNCHANGED
The value valid up to now (previous SET-DISK or presetting) remains unchanged.
USER-ALLOCATION = *STD
The value set with the SET-DISK-DEFAULTS command is valid.
USER-ALLOCATION = *SHARE
Only disk allocations of the allocation type task-shareable are permitted (all disk allocations resulting from DMS applications and reservations by means of SECURE-RESOURCE-ALLOCATION, except exclusive reservation for disks).
USER-ALLOCATION = *EXCLUSIVE
Only disk allocations of the allocation type task-exclusive are permitted (SECURE-RESOURCE-ALLOCATION=*EXCLUSIVE for disks).
USER-ALLOCATION = *ALL
Disk allocations of the allocation types task-shareable and task-exclusive are permitted.
USER-ALLOCATION = *NO
No disk allocations for the user type USE=DMS are permitted.
OPERATOR-CONTROL =
Determines whether the operator intends to check new allocations (first allocation attempt of a job for a private disk). The message is NKA0004. In this case, the allocation request is permitted or rejected only after confirmation by the operator. The operator’s reply to message NKA0004 is decisive for further access authorization for the appropriate job with respect to the disk; i.e. if the operator has not granted access authorization for a job, the job is not permitted to access the private disk unless the setting of this parameter is again changed with the SET-DISK-PARAMETER command. For jobs which already occupy the private disk at the time the parameter is set, the new parameter setting has no effect unless the job releases the disk and then attempts to allocate it again.
Confirmation by the operator is requested only once per job. Consequently, the message prompting the operator to authorize the allocation request is not repeated for a job which allocates the disk again once the operator has already replied to the message, regardless of whether the job has previously released the disk or not.
The system presetting is *STD.
OPERATOR-CONTROL = *UNCHANGED
The value valid up to now (previous SET-DISK or presetting) remains unchanged.
OPERATOR-CONTROL = *STD
The value set with the SET-DISK-DEFAULT command is valid.
OPERATOR-CONTROL = *SHARE
Only new allocations of the type task-shareable are checked.
OPERATOR-CONTROL = *EXCLUSIVE
Only new allocations of the type task-exclusive are checked.
OPERATOR-CONTROL = *ALL
New allocations of the types task-shareable and task-exclusive are checked.
OPERATOR-CONTROL = *NO
New disk allocations are not checked.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | NKV0001 | Syntax error | |
64 | NKA0094 | Command partially processed | |
64 | NKA0096 | Command not processed | |
130 | NKVD003 | NKA system task not available |