Issue a create connection request to create a connection to a note pad. An answer area is optional. If an answer area is provided, it must be large enough for a connection data record. Thus the answer area must have space for the answer area header, one data locator, and one connection data record.

Programs require appropriate SAF authorization to create a connection to a note pad. The access scope of the connection determines the type of authorization required. Specify the ACCESS keyword to indicate the type of access required for the connection. See System Authorization Facility (SAF) requirements.

In general, home and primary of the calling work unit must be the same address space. In the specific case of creating a connection for connector use (USAGE=CONNECTOR), an authorized program is permitted to run with primary not equal to home.

When creating a connection, you must provide the name of the note pad to which the connection is to be established. The create request is rejected if the note pad does not exist.

The usage classification determines the conditions under which a work unit is deemed to be a valid user of the connection for note processing. The creator of the connection specifies the USAGE keyword to indicate the manner in which the connection is to be used by the application. Three styles of usage are supported: connector, server, and client. See Usage classification for more information.

If the create request completes successfully, a connection data record is stored in the answer area if one is provided. Most of the information in the connection data record reflects the parameters and options specified on the create request. The connection related data that is set by XCF is also stored. In particular, the connection data record includes the connection identifier which might be useful when specifying selection criteria for a multi-note request. The connection data record also includes the timestamp of when the note pad was created. Your program might later need this timestamp when it deletes the note pad.