Check function (consistency check)

The check function (also called consistency check) is used to see whether the SF pubsets can be converted into an SM pubset that needs to be created or already exists.

The SMPGEN check function can be called with the following statements:

//MODIFY-SYSTEM-MANAGED-PUBSET
//CREATE-SYSTEM-MANAGED-PUBSET

Depending on whether the user is privileged (has the TSOS privilege) or not the check covers the following pubsets:

• nonprivileged users:
  Only pubsets on which the user’s user ID is entered are checked. The caller is informed of name conflicts and may be able to resolve these.
  Pubsets which the caller cannot access because his/her user ID is not entered there are excluded from the consistency check. SMPGEN issues a message to this effect. Further processing (creation or extension of SM pubsets) is not possible.

• privileged users (TSOS user ID, TSOS privilege):
  The privileged user can start the checks on the pubsets (by specifying the OPERATIONAL-MODE=*CHECK-NAME-CONSISTENCY operand) either only for his/her user ID or for all user IDs (suboperand USER-ID=*OWN/*ALL).

The statement is executed either in the current task or in a new batch task that is created. In the latter case, the user can continue to work with SMPGEN in parallel or terminate the program (Operand EXECUTION-MODE=*SYNCHRONOUS/*ASYNCHRONOUS).

When the consistency check is performed also depends on the privilege:

• nonprivileged users:
  For the nonprivileged user, the checks are always carried out during the current pubset session. The result therefore contains random components, since it may happen that names are constantly being cataloged or deleted. There is no time synchronization for information that is to be compared.

• privileged users (TSOS user ID, TSOS privilege):
  The privileged user has the choice of performing the checks in the current pubset session or with exclusive access by SMPGEN (PUBSET-STATE=*IMPORTED/*NOT-IMPORTED operand).

  If the second variant (exclusive access) is selected, the public disks are allocated system-exclusively by SMPGEN. A flag will be set in the MRSCAT entries of the pubset to indicate that they are currently being processed by SMPGEN. These pubsets can no longer be imported during the checks. Their MRSCAT entries cannot be deleted during processing. The pubset status displayed by /SHOW-PUBSET-ATTRIBUTES is “inaccessible”.

The consistency check also always runs (again) implicitly before SF pubsets are actually converted to SM pubsets.