$EcbDSet

From m204wiki
Revision as of 17:18, 2 January 2018 by JAL (talk | contribs) (minor formatting)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

$EcbDSet sets string data associated with an Event Control Block (ECB).

Syntax

$EcbDSet({ECB-number | 'CPQZ'},{'string'})

Where:

  • ECB-number is a numeric value (which may range from one to the value of the NECBS parameter) that identifies the ECB in which to store the string of data.
  • CPQZ is a named ECB used by the NonStop/204 facility to automatically post an extended quiesce. See Media recovery NonStop/204 for an explanation of the facility.

    To use CPQZ, you need not set the NECBS parameter. CPQZ can be expressed as a literal, a %variable, or a field name. When CPQZ is specified, the value of the $EcbDSet function can be non-null (except for error values) during only extended quiesce. CPQZ is internally cleared to null when the system exits extended quiesce.

  • string can be up to 255 bytes long.
  • Unless explicitly reset to null, data strings persist whether or not the ECB is posted. Depending on the sequence, data strings can be changed by either the $Post or $EcbDSet functions.

Usage

The $EcbDSet function returns the following return codes:

Return code Meaning
0 Success
2 Bad argument specified
3 NECBS parameter is not specified or is zero
4 The first argument is less than one or greater than the NECBS parameter
5 NUSERS = 1
7 $EcbDSet missing data argument
8 No argument specified
9 Extended quiesce environment error; issue a $StatusD function call for details.
11 Cannot be issued after QZSIG has been posted
12 Invalid argument CPQZ or invalid argument following QZSIG
13 Cannot be issued outside of extended quiesce

Note: The $EcbDSet function associates a string with an ECB, regardless of whether the ECB is posted or not. String data set by $EcbDSet is accessible using the $EcbDGet function.

Example

%x=$ecbdSet(1,'This is about managing user threads')

See also

The ECB-related $functions are: