IXGDELAB – Delete all blocks for a log stream

Function:

This sample JCL procedure will request that all the log blocks in a defined log stream be marked logically deleted.

Use:

This procedure can be used by an operator to delete all active log blocks in a log stream. Instead of writing a job to perform the logger connect and delete log block requests, the operator can start this procedure from the console.

Syntax:

s ixgdelab,logstrm=log_stream_name

Parameters:: log_stream_name
Name of the existing log stream which will have all its log blocks marked logically deleted.

Output:

When the procedure completes successfully, all the log blocks in the log stream will be logically deleted 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 IXGDELET. 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.