You can issue the modify command from the MVS™ console to dynamically modify product operations. This topic explains the syntax and parameters to use with the modify command when you want to display optimized local adapter status. This topic also demonstrates with an example how to use the modify command.
f <server>, parameters
server is the short name for the server to which the modify command is directed. This argument is required.
ADAPTER
ADAPTER is a parameter on the DISPLAY modify command. You can view the entire list of DISPLAY modify command parameters in the topic, Modify command. The following parameters are used to display the status of the optimized local adapters with the modify command. If you want to read more about this command, see the topic, Modify command.
Displays the status of the optimized local adapters component.
Displays a list of optimized local adapters clients connected to this server.
Displays a list of optimized local adapters clients connected to any server in this daemon group.
Displays a list of optimized local adapters clients connected to any server in this daemon group, matching search criteria.
Displays the Information Management System (IMS™) systems that this WebSphere® daemon group is connected to using Open Transaction Manager Access (OTMA), as well as the client names used to the connections.
OLATRACE
OLATRACE is a keyword with a parameter that
specifies the jobname associated with the optimized local adapter
exploiter with trace records that are to be displayed. The jobname
can be a particular job or can be a single asterik to extract all
adapter trace records. Formats and displays optimized local adapter
trace records to the WebSphere Application
Server SYSOUT, if tracing is enabled. To enable adapter tracing for
specific registrations or for broad situations, see the topic, Using
optimized local adapters diagnostic information.
Examples:
F BBOS001, DISPLAY, OLATRACE=WOLAJOB1
F BBOS001, DISPLAY, OLATRACE=*
******** OLATRACE modify command output start ****************************\n"; ******** Trace records for jobname: <jjjjjjjjj> < formatted trace records > ******** End of OLATRACE modify command output ***************************
To display the operational status of optimized local adapters, issue the following command: f server,display,adapter,status
BBOA0005I: STATUS: VER:1 MAX-CONN:100 DAEMON-GRP-NAME:SY1VER:1 indicates that version 1 of optimized local adapters is installed. MAX-CONN:100 reports that the WebSphere variable WAS_DAEMON_ONLY_adapter_max_conn is set to. DAEMON-GRP_NAME:SY1 indicates that the daemon group that this server is connected to is named SY1.
To display optimized local adapters clients connected to this server, issue the following command: f server,display,adapter,registrations
BBOA0006I: SHOWING REGISTRATIONS FOR SERVER: BBOA0000I: TYPE: s JOBNAME: BBOS001 NAME: *WASCTL* BBOA0001I: JOBNUM: 0 ACTIVE: true ACTIVE-CONNECTIONS: 0 BBOA0002I: MIN-CONN: 0 MAX-CONN: 0 STATE: 00 TRACELEVEL: 00 BBOA0023I: THIS REGISTRATION DOES NOT HAVE ANY CONNECTION HANDLES BBOA0026I: BBOA0003I: Name Jobname SWT TL Min Max Act State BBOA0004I: USSREGISTER1 IBMUSER5 000 02 0001 0005 0001 00Message BBOA0000I shows the jobname for the server which the display command was issued against.
Message BBOA0003I identifies the columns which will be displayed by message BBOA0004I.
To display optimized local adapters clients connected to a different server in this daemon group, issue the following command: f server,display,adapter,registrations,servername
To display optimized local adapters clients connected to any server in this daemon group, issue the following command: f server,display,adapter,daemongres
Shows registrations with a register name matching regname
Shows registrations whose MVS job number matches jobnum
Shows registrations whose MVS job name matches jobname
Shows registrations whose type is 'server' if the value is 1 or TRUE, or registrations whose type is not 'server' if the value is 0 or FALSE. A type 'server' registrations represents a WebSphere Application Server for z/OS® instance connected to the daemon group.
Shows registrations whose type is 'external address space' if the value is 1 or TRUE, or registrations whose type is not 'external address space' if the value is 0 or FALSE. An external address space is an address space which has registered with optimized local adapters using a BBOA1REG call.
Shows registrations which have enabled security by setting reg_flag_W2Cprop on the BBOA1REG call if the value is 1 or TRUE, or registrations which do not have security enabled if the value is 0 or FALSE.
Shows registrations which have enabled transactions by setting reg_flag_trans on the BBOA1REG call if the value is 1 or TRUE, or registrations which do not have transactions enabled if the value is 0 or FALSE.
Shows registrations which have a minimum connections count of value where value is an integer greater than or equal to 0.
Shows registrations which have a maximum connections count of value where value is an integer greater than or equal to 0.
Shows registrations which have a maximum connections count of value where value is an integer greater than or equal to 0.
Shows registrations which are at an optimized local adapters version level of value.
For example, to show all client registrations having security and transactions disabled, and with a job name of BBOCLIEN, issue the following command: f server,display,adapter,searchrges,sec=0,trans=0,extaddr=1,jobname=bboclien
For any of the display registrations, daemonrges or searchrges commands, the argument details can be appended to get detailed output. For example, to get a detailed list of registrations connected to this server, issue the following command: f server,display,adapter,registrations,details
BBOA0006I: SHOWING REGISTRATIONS FOR SERVER: BBOA0000I: TYPE: s JOBNAME: BBOS001 NAME: *WASCTL* BBOA0001I: JOBNUM: 0 ACTIVE: true ACTIVE-CONNECTIONS: 0 BBOA0002I: MIN-CONN: 0 MAX-CONN: 0 STATE: 00 TRACELEVEL: 00 BBOA0023I: THIS REGISTRATION DOES NOT HAVE ANY CONNECTION HANDLES BBOA0026I: BBOA0000I: TYPE: e JOBNAME: IBMUSER5 NAME: BBOAUSSREGISTER1 BBOA0001I: JOBNUM: 0 ACTIVE: true ACTIVE-CONNECTIONS: 1 BBOA0002I: MIN-CONN: 1 MAX-CONN: 5 STATE: 00 TRACELEVEL: 02 BBOA0024I: ID LSCB State BBOA0025I: 0x00000200065048e0 0x7f6ba0c8 PooledMessage BBOA0000I lists address spaces of type 'e' representing external address spaces (optimized local adapters clients), along with their MVS job name and optimized local adapters register name.
Message BBOA0001I shows the number of active connections for this registration.
Message BBOA0002I shows the minimum and maximum number of connections for this registration.
Message BBOA0024I is a header for a list of connections that follow.
Message BBOA0025I is issued once for each connection in this registration. There should be one BBOA0025I message for each active connection reported in message BBOA0001I. The ID and LSCB are unique identifiers for this connection. State represents the state of the connection. Pooled indicates that the connection is not currently in use by any application thread, but is available for a request. Err indicates the connection is processing an error condition. The states Ready, RegSent, RspRcvd, RegRcvd, and DataRcvd all describe various states of an interaction between the optimized local adapters client and the WebSphere Application Server for z/OS server instance.