The parameters for SETLOGR FORCE are:
When active connectors exist for the log stream, on a system where the force disconnect command is directed, Logger will first quiesce the connectors' activity for the log stream and then disconnect the log stream from the system. If Logger is unable to complete the logstream disconnect on the system, it may be necessary to issue another SETLOGR FORCE,DISCONNECT command.
Issuing the SETLOGR FORCE,DISCONNECT command when an offload is being held up, or a task is not responding, and any of the following messages are present: IXG271I, IXG272E, IXG311I, IXG312E, IXG114A, IXG115A, may cause ABEND47B or other ABENDs. Respond to these messages before issuing the SETLOGR FORCE,DISCONNECT command. See z/OS MVS Setting Up a Sysplex for more information about these messages.
If you issue the SETLOGR FORCE,DELETE command and the operation is unable to continue after the log stream had already been marked in the LOGR CDS as started to be deleted, then future attempts to connect to the log stream will fail and the log stream delete operation will be re-attempted at that time.
The net result will depend upon which Logger operation was attempting to access the (migrated) data set. Log stream browse requests might receive "gap" type error conditions meaning not all the log data can be browsed (read). Log stream offload failures might also result if an offload data set was migrated and needed to continue moving log data from "interim" storage to "secondary" (DASD) storage. See z/OS MVS System Messages, Vol 10 (IXC-IZP) for more information.
After this command is issued, you should continue monitoring the Logger activities to ensure no unexpected behaviors occur. Particularly, watch for the log stream exploiter that may have been directly affected by the recall request not completing successfully.
If Logger is not currently waiting on a recall for the data set, then the appropriate messages will be issued indicating the command has been completed. The command will have no effect on Logger's processing.
When the ALL keyword is specified with the ZAIQUIESCE option, then any log streams with the ZAI=YES specification that currently have log stream connections on the target z/OS image will be placed in the 'QUIESCED' state as described above. In addition, the z/OS IBM zAware log stream client manager state will be set as 'NOT AVAILABLE'. Any log streams subsequently connected on this system with the ZAI=YES specification will also be placed in the 'QUIESCED' state.
When the z/OS IBM zAware log stream client manager state changes to 'AVAILABLE', as a result of a SETLOGR FORCE,ZAICONNECT command, then any log streams that are newly connected to the z/OS image with the ZAI=YES specification will be allowed to attempt z/OS IBM zAware log stream client connections with the IBM zAware server. However, any log streams that were affected by the ZAIQUIESCE,ALL command will not be allowed to connect to the IBM zAware server until the appropriate SETLOGR FORCE,ZAICONNECT command is issued for these log stream(s), or the log stream is disconnected from the z/OS image and is then newly connected after the z/OS IBM zAware log stream client manager state has been set to 'AVAILABLE'.
When the ALL keyword is specified with the ZAICONNECT option, then the z/OS IBM zAware log stream client manager state will be set as 'AVAILABLE' for the z/OS image. Then any log stream that is connected and is currently using the ZAI=YES specification on the target z/OS image will be acted upon.
For each affected log stream, the current ZAI and ZAIDATA attributes will first be obtained from the log stream's definition (in the LOGR CDS), and then the necessary z/OS IBM zAware log stream client connect, disconnect (or a combination of both) actions will occur as follows:
Example 1, SETLOGR FORCE,DISC,LSN=SYSPLEX.OPERLOG:
SY1 d logger,c,lsn=SYSPLEX.OPERLOG
SY1 IXG601I 12.42.53 LOGGER DISPLAY 459
CONNECTION INFORMATION BY LOGSTREAM FOR SYSTEM SY1
LOGSTREAM STRUCTURE #CONN STATUS
--------- --------- ----- ------
SYSPLEX.OPERLOG LIST01 000001 DISCONNECT PENDING
NUMBER OF LOGSTREAMS: 000001
SY1 setlogr force,disc,lsn=SYSPLEX.OPERLOG
SY1 IXG651I SETLOGR FORCE DISCONNECT COMMAND ACCEPTED
FOR LOGSTREAM=SYSPLEX.OPERLOG
SY1 IXG661I SETLOGR FORCE DISCONNECT PROCESSED SUCCESSFULLY
FOR LOGSTREAM=SYSPLEX.OPERLOG
SY1 d logger,c,lsn=SYSPLEX.OPERLOG
SY1 IXG601I 12.43.15 LOGGER DISPLAY 466
CONNECTION INFORMATION BY LOGSTREAM FOR SYSTEM SY1
LOGSTREAM STRUCTURE #CONN STATUS
--------- --------- ----- ------
NO MATCHING INFORMATION FOUND.
Example 2, SETLOGR FORCE,NOREC,DSN= IXGLOGR.TEST102.STREAM01.A0000000
SY1 d logger,st,rec
D LOGGER,ST,REC
IXG601I hh.mm.ss LOGGER DISPLAY
SYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVE
LOGGER DATA SET RECALLS
GROUP: PRODUCTION
SECONDS DATA SET NAME
0000000024 IXGLOGR.TEST102.STREAM01.A0000000
GROUP: TEST
NO DATA SET RECALLS WAITING
SY1 setlogr force,norec,dsn=IXGLOGR.TEST102.STREAM01.A0000000
SY1 IXG601I SETLOGR FORCE NORECALL COMMAND ACCEPTED
FOR DSNAME=IXGLOGR.TEST102.STREAM01.A0000000
SY1 IXG280I IXGLOGR RECALL REQUEST STOPPED BY SETLOGR COMMAND
FOR DSN=IXGLOGR.TEST102.STREAM01.A0000000
SY1 IXG661I SETLOGR FORCE NORECALL PROCESSED SUCCESSFULLY
FOR DSNAME=IXGLOGR.TEST102.STREAM01.A0000000
SY1 d logger,st,rec
D LOGGER,ST,REC
IXG601I hh.mm.ss LOGGER DISPLAY
SYSTEM LOGGER STATUS
SYSTEM SYSTEM LOGGER STATUS
------ --------------------
SY1 ACTIVE
LOGGER DATA SET RECALLS
GROUP: PRODUCTION
NO DATA SET RECALLS WAITING
GROUP: TEST
NO DATA SET RECALLS WAITING
Example 3, SETLOGR FORCE,ZAIQUI,ALL:
SY1 SETLOGR FORCE,ZAIQUI,ALL
SY1 IXG651I SETLOGR FORCE ZAIQUIESCE COMMAND ACCEPTED
FOR ALL LOGSTREAMS
SY1 IXG371E ZAI LOGSTREAM CLIENT MANAGER UNAVAILABLE.
REASON: SETLOGR COMMAND REQUEST.
SY1 IXG382I ZAI LOGSTREAM CLIENT QUIESCED
FOR LOGSTREAM SYSPLEX.OPERLOG
REASON: SETLOGR COMMAND REQUEST.
Example 4, SETLOGR FORCE,ZAICONN,LSN=SYSPLEX.OPERLOG:
SY1 SETLOGR FORCE,ZAICONN,LSN=SYSPLEX.OPERLOG
SY1 IXG651I SETLOGR FORCE ZAICONNECT COMMAND ACCEPTED
FOR LOGSTREAM=SYSPLEX.OPERLOG
SY1 IXG380I ZAI LOGSTREAM CLIENT ESTABLISHED
FOR LOGSTREAM SYSPLEX.OPERLOG