Set Pointer Reset Boundary (QYASPPRBDY) API


  Required Parameter Group:

1 Option Input Binary(4)
2 Error Code I/O Char(*)

  Default Public Authority: *EXCLUDE

  Threadsafe: Yes

The Set Pointer Reset Boundary (QYASPPRBDY) API sets an IPL boundary for invalidating any pointer within *SYSBAS that contains an address of an object in an IASP.


Authorities and Locks

None.


Required Parameter Group

Option
INPUT; BINARY(4)

An integer value indicating which pointer reset option is to be performed. Valid option values are:

0 Sets the default behavior. A subsequent IPL will be a boundary for resetting pointers only if the machine determines that it needs to be.
1 The next IPL is to be a boundary for resetting pointers. This option can be used when a copy of an IASP is made and the system had online the IASP from which the copy was made. The effect can be avoiding an additional IPL that otherwise would be required for the IASP to be accepted by the system.
2 All subsequent IPLs are to be a boundaries for resetting pointers. This is the same as option 1 but is effective on all IPLs.
Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID Error Message Text
CPF3C36 E Number of parameters, &1, entered for this API was not valid.
CPF3C3C E Value for parameter &1 not valid.
CPF3CF1 E Error code parameter not valid.
CPFXXXX E Option parameter not valid.



API introduced: V5R4

[ Back to top | Configuration APIs | APIs by category ]