IXGCONN: Connecting to and disconnecting from a log stream

Use the IXGCONN service to connect to or disconnect from a log stream. An application must issue IXGCONN with REQUEST=CONNECT before it can read, write, or delete data in a log stream.

When the IXGCONN REQUEST=CONNECT request completes, it returns a unique connection identifier, called a STREAMTOKEN, to the calling program. The application uses the token in subsequent logger service requests to identify its connection to the log stream.

In the answer area (IXGANSAA) returned by IXGCONN, bit Ansaa_DynMgmtOffEntryToEleActive is on when system logger is dynamically managing the entry-to-element ratio. See the system logger chapter in z/OS MVS Setting Up a Sysplex for information about dynamic management of the entry-to-element ratio.

For IXGCONN REQUEST=CONNECT AUTH=WRITE, bit Ansaa_WriteTriggersReturned indicates IXGWRITE requests may have the Ansaa_WriteTriggers filled in the answer area of the IXGWRITE. See Write triggers for additional information.

Note: The following services contain parameters for both authorized and unauthorized programs: IXGCONN, IXGBRWSE, IXGWRITE, and IXGDELET. All other system logger services and their parameters can be used by any program. All the unauthorized guidance for system logger is contained in this chapter. The following topics have moved to the Authorized Assembler Services Guide:
Parent topic: Using system logger services