Environment

The following table contains the requirements for the caller:

Minimum authorization:	Supervisor state or problem state Any PSW-key mask (PKM) Programs require appropriate SAF (System Authorization Facility) authorization to the FACILITY class resource IXCNOTE.`owner`.`application` when creating, deleting, or querying a note pad, and when creating a connection to a note pad. The `owner` and `application` are derived from the note pad name. To create or delete a note pad, the program must have CONTROL access. To query a note pad, the program must have READ access. To create a connection to a note pad that can be used to create, read, write, replace, or delete notes, the program must have UPDATE access. To create a connection to a note pad that can only read notes, the program must have READ access. A program that uses a connection must be recognized by XCF as a valid user of the connection. Each applicable request documents the conditions under which a program is deemed to be a valid user. If the program is not recognized as a valid user, XCF might perform a SAF check to verify that the user has the authority appropriate for the request. Note that all SAF checking is performed against the security environment of the work unit. For a task that has a task specific security environment, the Access Control Environment Element (ACEE) anchored at offset TCBSENV in the TCB (macro IKJTCB) is used. For an SRB, or a task for which TCBSENV is zero, the ACEE anchored at offset ASXBSENV in the ASXB (macro IHAASXB) for the home address space is used. If SAF is not available, or if there is no IXCNOTE.`owner`.`application` resource defined for the note pad in the FACILITY class, a request to create, delete, query, or connect to a note pad is rejected if the program is running in problem state with a PKM allowing key 8-15 (IXCNOTERSNNOSECPROFILE). Such requests are accepted if the program is running in supervisor state or with a PKM allowing key 0-7. However, note that the program will need to run in supervisor state or with a PKM allowing key 0-7 when using a connection that was created under these circumstances. Any program that specifies USAGE=SERVER or USAGE=CLIENT when creating a connection to a note pad must be running in supervisor state or with a PKM allowing key 0-7.
Dispatchable unit mode:	Task or SRB mode
Cross memory mode:	Any PASN, any HASN, any SASN Problem state programs with a PKM allowing key 8-15 must be running task mode with home and primary being the same address space for the following requests: REQUEST=NOTEPAD REQTYPE=CREATE REQUEST=NOTEPAD REQTYPE=QUERY REQUEST=NOTEPAD REQTYPE=DELETE REQUEST=CONNECTION REQTYPE=CREATE Any program that specifies USAGE=SERVER or USAGE=CLIENT when creating a connection to a note pad must be running with home and primary being the same address space.
AMODE:	31-bit or 64-bit If in 64-bit mode, specify SYSSTATE AMODE64=YES before invoking this macro.
ASC mode:	Primary or access register (AR) If in Access Register ASC mode, specify SYSSTATE ASCENV=AR before invoking this macro.
Interrupt status:	Enabled for I/O and external interrupts
Locks:	No locks held
Control parameters:	Control parameters must be in the primary address space or, for AR-mode callers, must be in an address/data space that is addressable through a public entry on the caller's Dispatchable Unit Access List (DU-AL). The control parameters can also reside in a common area data space. The control parameters must be accessible using the PSW key of the program making the request. The service routine will always fetch the control parameters. It might also store into them.