IXGOFLDS – Initiate® an offload for a log stream

Function:

This sample JCL procedure will initiate an offload for all log blocks to DASD (secondary storage) for a defined log stream.

Use:

This procedure can be used by an operator to request data be off-loaded from primary storage (for example, CF structure) to secondary storage (DASD).

Syntax:

s ixgoflds,logstrm=log_stream_name

Parameters:: log_stream_name
Name of the log stream for the log blocks to be off-loaded.

Output:

When the procedure completes successfully, all the log blocks in the log stream will be off-loaded to DASD and message IXG273I will be issued to the console. When the procedure fails, message IXG274I will be issued to the console stating which function failed and listing the return and reason code.

Note: Logger may also issue other messages to indicate whether the request was successful or not.

Requires:

Access to procedure library used by the installation from submitting userid. Assuming Security Authority Facility (SAF) is available and CLASS(LOGSTRM) is defined to SAF, UPDATE access to the RESOURCE(log_stream_name) CLASS(LOGSTRM) is required by the owning userid to allow the program invoked by the procedure to connect to the log stream with WRITE authority.

References:

See z/OS MVS Programming: Authorized Assembler Services Reference EDT-IXG for more information on IXGCONN and IXGOFFLD. You can also search the IXGCON mapping macro in z/OS® MVS™ Data Areas in http://www.ibm.com/systems/z/os/zos/bkserv/ for a return and reason code, and take the suggested action.