Delete entry from MRSCAT of home pubset
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Routing code: | $ |
Function
The values for a catalog entry in the MRSCAT of the home pubset which are preset with the ADD-MASTER-CATALOG-ENTRY command can be modified using this command, both for single-feature pubsets (SF pubsets) and for system-managed pubsets (SM pubsets).
Note that this command cannot be used to change the pubset type or a volume set entry. Any changes that are made do not take effect until the next time the pubset is imported (IMPORT-PUBSET command).
The availability of the catalog can be governed with the IMPORT-PUBSET command.
The default value *UNCHANGED in the relevant operands indicates that the previous specification remains valid.
Format
MODIFY-MASTER-CATALOG-ENTRY | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
ENTRY-NAME = <cat-id 1..4>
Catalog ID of the pubset for which the MRSCAT entry is to be modified.
PUBSET-TYPE = *BY-PUBSET / *SINGLE-FEATURE(...) / *SYSTEM-MANAGED(...)
Defines the type of pubset for which the MRSCAT entry is to be modified. The pubset type itself cannot be changed. The attributes specific to a pubset type cannot be modified unless the pubset type is specified explicitly.
PUBSET-TYPE = *BY-PUBSET
The pubset type is read from the MRSCAT entry.
PUBSET-TYPE = *SINGLE-FEATURE(...)
The pubset for which the MRSCAT entry is to be modified is an SF pubset.
START-SPEEDCAT = *UNCHANGED / *NO / *SPEEDCAT-TASK / *OWN-TASK
Specifies whether SCA should be started when this pubset is imported.
START-SPEEDCAT = *NO
SCA should not be started when this pubset is imported.
START-SPEEDCAT = *SPEEDCAT-TASK
SCA should be available and should run under a separate task, the SPEEDCAT task.
START-SPEEDCAT = *OWN-TASK
SCA should be available and should run under the user’s task.
PHYSICAL-ALLOCATION = *UNCHANGED / *ADMINISTRATOR-ONLY / *USER-ALLOWED
Specifies whether users are allowed to make direct allocations to specific volumes of the pubset.
PHYSICAL-ALLOCATION = *ADMINISTRATOR-ONLY
Users may not directly allocate the volumes of the pubset. This right is reserved for the privileged caller under TSOS.
PHYSICAL-ALLOCATION = *USER-ALLOWED
On this pubset, nonprivileged users should also be permitted to allocate individual volumes directly.
NEXT-CATALOG-EXPORT = *UNCHANGED / *NO-CONVERSION / *V10-COMPATIBLE
This operand is only still available for reasons of compatibility.
ALLOCATION = *UNCHANGED / *PARAMETERS(...)
Specifies whether particular allocation parameters should be set for file processing on the pubset.
ALLOCATION = *PARAMETERS(...)
Specifies allocation parameters for the pubset, with the values which follow.
SATURATION-LEVEL4 = *UNCHANGED / *STD / <integer 66..2147483647 2Kbyte >
The allocation parameter is to be set for memory saturation level 4. If saturation levels have already been defined with the MODIFY-SPACE-SATURATION-LEVELS command, they should not be changed with the MODIFY-MASTER-CATALOG-ENTRY command because in that case there would be no checking of the saturation levels.
SATURATION-LEVEL4 = *STD
The value defined in the system parameter L4SPDEF is to apply.
SATURATION-LEVEL4 = <integer 66..2147483647 2Kbyte >
Value of memory saturation level 4 which is to apply to this pubset.
PRIMARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..16777215 2Kbyte >
The allocation parameter, for the primary allocation when a storage space request is made (file processing), is to be set.
PRIMARY-ALLOCATION = *STD
The value defined in the system parameter DMPRALL is to apply.
PRIMARY-ALLOCATION = <integer 1..16777215 2Kbyte >
The value to be applied for this pubset, for primary storage space allocations during file processing. This value will apply as the default value for any user who does not specify a value for an initial allocation in a storage space request.
SECONDARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..32767 2Kbyte >
The allocation parameter, for secondary allocations when a storage space request is made (file processing), is to be set.
SECONDARY-ALLOCATION = *STD
The value defined in the system parameter DMSCALL is to apply.
SECONDARY-ALLOCATION = <integer 1..32767 2Kbyte >
The value to be applied for this pubset, for secondary storage space allocations during file processing. This value will apply as the default value for any user who does not specify a value for another allocation in a storage space request.
MAXIMAL-ALLOCATION = *UNCHANGED / *STD / <integer 1..32767 2Kbyte >
The allocation parameter, for doubling the secondary allocation when a storage space request is made (file processing), is to be set.
MAXIMAL-ALLOCATION = *STD
The value defined in the system parameter DMMAXSC is to apply.
MAXIMAL-ALLOCATION = <integer 1..32767 2Kbyte >
The value to be applied for this pubset, for doubling of the secondary storage space allocation during file processing. This value will be the maximum value for any user, for whom the space remains inadequate even after a secondary allocation has been made. The value for the secondary allocation will be repeatedly doubled until the maximum value specified here is reached.
PUBSET-TYPE = *SYSTEM-MANAGED(...)
The pubset for which the MRSCAT entry is to be modified is an SM pubset.
CONTROL-VOLUME-SET = *UNCHANGED / <cat-id 1..4>
Specifies which volume set is to be used as the control volume set when the SM pubset is imported.
CONTROL-VOLUME-SET = <cat-id 1..4>
Indicates the catalog ID of the volume set which is to be used as the control volume set when the SM pubset is imported. The specified volume set must also be recorded as a control volume set in the SM pubset’s configuration file.
PARTNER-NAME = *UNCHANGED / <alphanum-name 1..8>
BCAM name of the processor for remote file access (RFA). A processor may only be specified if no MSCF connection exists, but remote file access is required.
ACCESS-FAILURE = *UNCHANGED / *HOLD-JOBS / *CANCEL-JOBS
Only for a shared pubset:
Defines the behavior if the MSCF connection to the master of an imported shared pubset is lost.
ACCESS-FAILURE = *HOLD JOBS
The pubset is set to the LOCAL-IMPORTED, QUIET state for the duration of the connection interruption.
Tasks that access the pubset enter a wait state, the duration of which is defined by the
BATCH-WAIT-TIME or DIALOG-WAIT-TIME parameter (see below).
ACCESS-FAILURE = *CANCEL-JOBS
The pubset is set to the INACC state for the duration of the connection interruption. Attempts to access
the pubset are immediately rejected - at program level with a corresponding return code, at command
level by triggering a spin-off. The parameters BATCH-WAIT-TIME and DIALOG-WAIT-TIME are not evaluated.
RESIDENT-BUFFERS = *UNCHANGED / *NO / *YES
Specifies whether resident or nonresident buffers are to be created. Please, note possible interaction with the NUMBER-OF-BUFFERS operand (see there).
RESIDENT-BUFFERS = *NO
Nonresident buffers are created.
RESIDENT-BUFFERS = *YES
Resident buffers are created.
NUMBER-OF-BUFFERS = *UNCHANGED / <integer 1..255>
Defines the number of buffers.
If the CATBUFR and BMTNUM system parameters were entered in MRSCAT as potentially active (command ADD-MASTER-CATALOG-ENTRY RESIDENT-BUFFERS=*SYSTEM-STD, NUMBER-OF-BUFFERS=*SYSTEM-STD) and only one of both operands was modified via the MODIFY-MASTER-CATALOG-ENTRY command, so the other one will be given the default value: RESIDENT-BUFFERS=*NO, NUMBER-OF-BUFFERS=32 regardless *UNCHANGED was specified.
The buffer specification is evaluated - according to the following hierarchy - only when the pubset is imported:
Explicit parameter specification in the IMPORT-PUBLIC-VOLUME-SET command
Specifications via the ADD- or MODIFY-MASTER-CATALOG-ENTRY command.
If only one of the operands RESIDENT-BUFFERS or NUMBER-OF-BUFFERS is specified, the default value applies to the other operand (RESIDENT-BUFFERS=*NO, NUMBER-OF-BUFFERS=32).
Specification according to system parameters CATBUFR and BMTNUM.
If the specified value of NUMBER-OF-BUFFERS is less than 32, it is increased to 32.
BATCH-WAIT-TIME = *UNCHANGED / <integer 0..2147483647 seconds >
Only for a shared pubset with the setting ACCESS-FAILURE=*HOLD-JOBS
Time in seconds that batch jobs are to wait for the availability of pubsets that cannot be accessed due to a connection failure. If the time specified is exceeded, command processing is aborted with an error code and the spin-off mechanism is triggered.
DIALOG-WAIT-TIME = *UNCHANGED / <integer 0..2147483647 seconds >
Only for a shared pubset with the setting ACCESS-FAILURE=*HOLD-JOBS
As with batch jobs, defines the wait time spread in the event of interactive accesses to pubsets in the QUIET status. If the time specified is exceeded, the interactive job receives a message and is resumed. The default value here is 30 seconds.
SHARED-PUBSET = *UNCHANGED / *NO / *YES
Determines the shareability of the pubset for local processors.
ACCESS-CONTROLLED = *UNCHANGED / *NO / *YES(...)
Specifies whether access to the pubset is to be restricted to one user ID.
ACCESS-CONTROLLED = *NO
Access to the pubset is not subject to any restrictions.
ACCESS-CONTROLLED = *YES(...)
Access to the pubset is to be restricted to one user ID. The IMPORT-PUBSET command is rejected with an error in the case of a shared pubset flagged as ACCESS-CONTROLLED=*YES.
USER-IDENTIFICATION = *UNCHANGED / <alphanum-name 1..8> / TSOS
Specifies the user ID which is to have access to the pubset.
USER-IDENTIFICATION = <alphanum-name 1..8>
Specifies a user ID, in addition to the TSOS user ID, which is to be permitted access to the pubset.
EAM = *UNCHANGED / *PARAMETERS(...)
Specifies the SYSEAM file parameters specific to this pubset.
EAM = *PARAMETERS(...)
Specifies the SYSEAM parameters which follow for the pubset.
MAXIMAL-SIZE = *UNCHANGED / *STD / <integer 12..193536 2Kbyte >
This operand is only supported for reasons of compatibility and is no longer evaluated.
MINIMAL-SIZE = *UNCHANGED / *STD / <integer 12..193536 2Kbyte >
Specifies the minimum size (number of half pages) that the SYSEAM file may occupy in the specified pubset.
MINIMAL-SIZE = *STD
The value specified in the system parameter EAMMIN is to apply.
MINIMAL-SIZE = <integer 12..193536>
Minimum size (number of half pages) that the SYSEAM file may occupy in the pubset.
SECONDARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..193536 2Kbyte >
Specifies the secondary allocation for the SYSEAM file, for this pubset.
SECONDARY-ALLOCATION = *STD
The value specified in the system parameter EAMSEC is to apply.
SECONDARY-ALLOCATION = <integer 1..193536 2Kbyte >
Value of the secondary allocation for the SYSEAM file (number of half pages). This value should be a multiple of 24.
VIRTUAL-MEMORY = *UNCHANGED / *STD / <integer 0..8192 2Kbyte >
Specifies the number of half pages to be used in determining the size of the EAM cache area in class 4 memory. A cache area can only be created for the SYSEAM file of the home pubset. The parameter has no effect for any other pubsets.
VIRTUAL-MEMORY = *STD
The size of the EAM cache area will be determined from the value of the system parameter EAMMEM.
VIRTUAL-MEMORY = <integer 0..8192 2Kbyte >
The number of half pages specified here determines the size of the EAM cache area.
REMOTE-IMPORT = *UNCHANGED / *BY-CONNECTION / *BY-COMMAND-ONLY
Defines how the remote import status can be changed.
REMOTE-IMPORT = *BY-CONNECTION
The change is made on connection setup.
REMOTE-IMPORT = *BY-COMMAND-ONLY
The remote import status can only be changed by a command.
XCS-CONFIGURATION = *UNCHANGED / *NO / *YES
For shared pubset only: Defines whether the pubset may be automatically imported as an XCS pubset when a new XCS network is established.
XCS-CONFIGURATION = *NO
The pubset must not be imported automatically as an XCS pubset. (The pubset may nonetheless be used as an XCS pubset using the SET-XCS-PUBSET command.)
XCS-CONFIGURATION = *YES
The pubset is to be imported automatically as an XCS pubset by the MSCF subsystem when a new XCS network is established.
PUBRES-UNIT = *UNCHANGED / <alphanum-name 2..2> / <x-text 4..4>
Mnemonic device name (MN) of the pubres of the SF pubset or of the volres of the SM pubset. VM2000 requires this entry when the pubset is specified by means of its catalog ID.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
2 | 0 | CMS0002 | Disk error |
1 | CMS0011 | Syntax error | |
1 | CMS0314 | Syntax error in entry name or error in wildcard specification | |
32 | CMD0221 | Internal system error | |
32 | CMS031F | MRSCAT parameter error | |
32 | CMS0310 | Error during privilege checking | |
32 | CMS0317 | MRSCAT is locked | |
32 | CMS0318 | Synchronization error | |
64 | CMS0010 | No authorization for command | |
64 | CMS0312 | MRSCAT entry not found | |
64 | CMS0319 | Pubset type conflict |
Note
For handling of the buffer specifications, see the notes under the IMPORT-PUBSET command.
Example
Locally modifying catalog entries and importing pubsets (MPVS)
A, BAD and DAT are pubsets which are to be accessed locally via a single host. A is the home pubset.
The following commands must be issued:
|
|
|
|
|
|
|
|
The MRSCAT catalog directory in the home pubset contains the following lines:
PUBSET A:LOCAL-HOME PUBSET BAD:LOCAL-IMPORTED,SHARED,MASTER-HOST=OWN-HOST PUBSET DAT:LOCAL-IMPORTED