(zos)

Displaying optimized local adapter status with the Modify command

We 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 to display optimized local adapter status. This topic also demonstrates with an example how to use the modify command.

We can use the modify command to display the status of various server components and activities, including the following components:

• Active controllers

• Trace settings

• Servants

• Sessions

• JVM heap

• Java trace

Use the following format when entering 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.

Parameters

ADAPTER is a parameter on the DISPLAY modify command. We 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. To read more about this command, see the topic, Modify command.

• STATUS

  Displays the status of the optimized local adapters component.

• REGISTRATIONS

  Displays a list of optimized local adapters clients connected to this server.

• DAEMONRGES

  Displays a list of optimized local adapters clients connected to any server in this daemon group.

• SEARCHRGES

  Displays a list of optimized local adapters clients connected to any server in this daemon group, matching search criteria.

• OTMANAMES

  Displays the Information Management System (IMS™) systems that this WebSphere daemon group is connected to using Open Transaction Manager Access (OTMA), and the client names used to the connections.

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 asterisk to extract all adapter trace records. Formats and displays optimized local adapter trace records to the WAS 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.

Example 1

F server, DISPLAY, OLATRACE=jjjjjjjj

• Display any available trace data for job WOLAJOB1:

  F BBOS001, DISPLAY, OLATRACE=WOLAJOB1

• Display all available optimized local adapter data:

  F BBOS001, DISPLAY, OLATRACE=*

In both examples, the system dumps matching trace records to the server SYSOUT spool data. For a given use of the modify DISPLAY OLATRACE command, the trace report in SYSOUT is delimited by a header and footer line as follows:

******** 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

The status of optimized local adapters is displayed on the MVS console as follows:

BBOA0005I: STATUS: VER:1 MAX-CONN:100 DAEMON-GRP-NAME:SY1

VER: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

A list of clients (address spaces which have issued BBOA1REG) are displayed on the MVS console as follows:

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 00

• Message BBOA0000I shows the jobname for the server which the display command was issued against.

• Message BBOA0003I identifies the columns which are displayed by message BBOA0004I.

• Message BBOA0004I is issued once for each optimized local adapters client connected to this server:

• Name identifies the registration name for the client (supplied on BBOA1REG).

• Jobname represents the job name of the client address space

• SWT represents flags describing the security and transactional environment of the client.

• S is set to 1 if security is enabled by setting reg_flag_W2Cprop on the BBOA1REG call.

• T is set to 1 if transaction support is enabled by setting reg_flag_trans on the BBOA1REG call.

• W is always set to 0.

• TL represents the trace level for this registration. The default value is 02.

• Min represents the minimum number of connections specified on the BBOA1REG call.

• Max represents the maximum number of connections specified on the BBOA1REG call.

• Act represents the current number of connections in the connection pool for this registration.

• State is for use by IBM Support.

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

To display optimized local adapters clients matching search criteria, issue the following command: f server,display,adapter,searchrges,criteria where criteria can be:

• NAME=regname

  Shows registrations with a register name matching regname

• JOBNUM=jobnum

  Shows registrations whose MVS job number matches jobnum

• JOBNAME=jobname

  Shows registrations whose MVS job name matches jobname

• SERVER=value

  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 WAS for z/OS instance connected to the daemon group.

• EXTADDR=value

  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.

• SEC=value

  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.

• TRANS=value

  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.

• MINCONN=value

  Shows registrations which have a minimum connections count of value where value is an integer greater than or equal to 0.

• MAXCONN=value

  Shows registrations which have a maximum connections count of value where value is an integer greater than or equal to 0.

• ACTCONN=value

  Shows registrations which have a maximum connections count of value where value is an integer greater than or equal to 0.

• VERSION=value

  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

The output is as follows:

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 Pooled

Message 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 WAS for z/OS server instance.

Related

Modify command