System FIELDS FOR SIMULTANEOUS UPDATE

@DS_MESSAGE

Type;  CHAR

Length;  60

contains a string that is displayed while a PM waits for a queued DS.  The message is displayed every 30 seconds until access is granted, or @DS_WAIT seconds elapse.  The default message is “Waiting for {N} in use by PID {H} User {S}.”   The message can be changed by modifying the system field, which can contain any text string, with {N}, {I}, and/or {S} inserted (in that order).  The {N}, {I}, and {S} will be replaced by the actual DS name, the current job number, and user name, respectively, when the message is displayed.  (If more than one user has the DS, the one shown is chosen at random.) This message may be disabled by using the default override clause in the RELATE statement, or by storing blanks into @DS_MESSAGE. In contrast to @WAIT_MESSAGE (see below), this message displays when a queue has been established and the PM is in the queue.

@DS_WAIT

Type; INT

Length; 10

contains the maximum number of seconds to wait for a queued DS.  The default is 300 seconds (5 minutes).  A negative value means wait forever.  A zero value indicates that the PM should not wait for a queued DS.  When @DS_WAIT seconds elapse before successful access, the PM will stop executing.

It is recommended that @DS_WAIT be set to at least twice the time in @RECORD_WAIT to avoid having the PM abort while waiting to access a busy DS.

@QUEUE_QUOTA

Type; INT

Length; 10

(read-only system field) is set to the user’s ENQ/DEQ quota when ACCENT R is invoked.  This field indicates the number of locking resources a user is allowed, and determines whether the user can run an application using multiple GET LOCKED statements or whether a LOCK should be used instead.

See also:  ENQ/DEQ quota - “Locking Resources” (later in this section)

@QUEUE_STATUS

Type;  CHAR

Length;  11

(read-only system field) contains the queue status of global memory access.  The value must be “System-Wide” for ACCENT R to function correctly.

@RECORD_MESSAGE

Type;  CHAR

Length;  60

contains the string that is displayed while a PM waits for a queued record. The message is displayed every 30 seconds until access is granted or until @RECORD_WAIT seconds elapse.  The default message is “Waiting for {N} in use by PID {H} User {S}.”  The message can be changed by modifying the system field, which can contain any text string, with {N}, {I}, and/or {S} inserted (in that order).  The {N}, {I}, and {S} will be replaced by the actual DS name, the current job number, and user name, respectively, when the message is displayed.  (If more than one user has the DS, the name given is chosen at random).  The message may be disabled by the default override clause in the RELATE statement, or by storing blanks into @RECORD_ MESSAGE.

@RECORD_WAIT

Type;  INT

Length;  10

contains the maximum number of seconds to wait for a queued record.  The default is 300 seconds.  A negative value means wait forever.  A zero value indicates that the PM will not wait for a queued record.  When @RECORD_WAIT seconds elapse before successful access, the PM statement fails, @AUX is set to “BUSY”, and the PM continues.  When doing CREATE's, set @RECORD_WAIT to a value large enough to give the system a chance to retry if it is not successful in adding the record on the first attempt.

@WAIT_MESSAGE

Type;  CHAR

Length;  40

contains the text that is displayed if a DS is busy and cannot be opened.  This message displays periodically during the period of time set to @WAIT_SECONDS.  In contrast to @DS_MESSAGE this message displays in the default access environment, when no queue has been established for the DS.

@WAIT_SECONDS

Type;  INT

Length;  10

contains the maximum number of seconds to attempt opening a DS. A DS has to be successfully opened before being queued.  The default is 10 seconds.