z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


List Controls That Can Be Updated Using WRITE_LCONTROLS

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

The following list controls can be updated using WRITE_LCONTROLS:
  • The list limit, which can be either of the following:
    • The maximum number of list entries allowed on the list
    • The maximum number of data elements allowed on the list.

    The choice of limit type is specified using the LISTCNTLTYPE parameter on the IXLCONN macro when the structure is allocated. The initial value of the list limit for each list is the maximum number of list entries or data elements for the entire structure. So, in effect, you could place all list entries in the list structure on a single list.

  • The list description. An optional, user-defined description of the list. The list description for each list is initialized to zeros when the structure is allocated.
  • The list authority. Applications optionally can define a list authority value that must be specified when users update list controls. The list authority value for each list is initialized to zeros when the structure is allocated.

    For a list structure allocated in a CFLEVEL=1 or higher coupling facility, several IXLLIST requests can be made conditional upon the success of a list authority comparison. Some IXLLIST requests can also update the list authority.

  • The list key. LISTKEY specifies an optional list key value that is associated with the list. The list key can be assigned to a list entry automatically when a list entry is created or moved. Some IXLLIST requests can also update the list key value by specifying a list key increment. LISTKEY is valid only for structures in a coupling facility with CFLEVEL=1 or higher. See Understanding List Entry Key Assignment.
  • The maximum list key. MAXLISTKEY specifies an optional list key value that provides an upper boundary for the list key. IXLLIST commands that specify automatic list key assignment can also increment the current list key value. When the maximum list key value is exceeded, the system will not automatically assign a list key to a list entry. MAXLISTKEY is valid only for structures in a coupling facility with CFLEVEL=1 or higher.
  • The location of the list cursor and the list cursor direction. SETCURSOR is an optional method (for structures allocated in a CFLEVEL=1 or higher coupling facility) of setting the list cursor to the first list entry on the list with a list cursor direction of head-to-tail or to the last list entry on the list with a list cursor direction of tail-to-head.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014