Version 9.6	SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT

EntireX Broker provides the following internal services: Command Service and Information Service, which can be used to administer and monitor brokers. Because these services are implemented internally, nothing has to be started or configured. You can use these services immediately after starting EntireX Broker. This document covers the following topics:

• ETBINFO

• ETBCMD

• ETBSRV

ETBINFO

Queries the Broker for different types of information, generating an output text string with basic formatting. This text output can be further processed by script languages. ETBINFO uses data descriptions called profiles to control the type of data that is returned for a request. ETBINFO is useful for monitoring and administering EntireX Broker efficiently, for example how many users can run concurrently and whether the number of specified message containers is large enough.

Although basic formatting of the output is available, it is usually formatted by script languages or other means external to the Broker.

• Running the Command-line Utility

• Command-line Parameters

• Command-line Parameters from File

• Profile

• Format String

Running the Command-line Utility

In a z/OS environment, run the command-line utility ETBINFO as shown below.

Note:
The service data set name and member cannot be accessed directly, but only indirectly by its DD name in the JCL.

//ETBINFO EXEC PGM=ETBINFO,
// PARM=('ENVAR(''ETB_STUBLOG=0'')/ -p "//''EXX960.JOBS(BROKER)''" ',
//       '-bbrokerid -dBROKER -xuid -ypwd')
//STEPLIB  DD   DISP=SHR,DSN=< EXB-load-lib >
//         DD   DISP=SHR,DSN=< EXX-load-lib >
//         DD   DISP=SHR,DSN=< WAL-load-lib >
//TRACE1   DD   SYSOUT=*                               stublog
//SYSOUT   DD   SYSOUT=*                               stderr
//SYSPRINT DD   SYSOUT=*                               stdout
//

The SVC number specified in the ADARUN parameter must match the SVC number used for the target Broker ID.

Command-line Parameters

The table below explains the command-line parameters. The format string and profile parameters are described in detail following the table. All entries in the Option column are case-sensitive.

Command-line Parameters from File

ETBINFO supports an alternative method of passing command-line parameters.

If the DDNAME INFFILE is allocated, using

//INFFILE  DD  DISP=SHR,DSN=pds(member)

and no command-line parameters are specified in the EXEC instruction, the content of the allocated member is evaluated. See sample member below (the apostrophes are included to show the record format (LRECL 80):

'-blocalhost:3930:TCP                                                            '
'-dBROKER                                                                        '

If ETBINFO is configured using INFFILE and a profile is specified, the syntax of the -p is as follows:

The syntax is based on IBM conventions for fopen.

Caution:
Make sure INFFILE does not contain line numbers in columns 73-80. If line nubmers are present, arguments are not passed correctly.

Profile

If you do not use the profile option or a format string, your output will be an unformatted list with all columns of that display type. To display specific columns, specify a profile that includes only those columns.

The following default sample profiles include all the columns defined for each display type:

You can either delete the columns not required or copy the default profile and modify the order of the columns. Ensure that the column names have a leading "%". Column names can be written in one line or on separate lines. The output is always written side by side.

Location of Profiles

On z/OS, the profiles used to control the format of data displayed are members of the EXB source library and are named SERVER, CLIENT, etc. They can be saved as either sequential files or PDS members.

Example 1

Profile for object SERVICE: SERVICE.

//ETBINFO EXEC PGM=ETBINFO,PARM=('/-b ETB001::NET -d SERVICE ',
//         '-p "//''EXX960.JOBS(SERVICE)''" -l FULL -xUID')

The following list is displayed:

SAG                              ETBCIS     INFO  
 1 0 16 86400 0 31647 0 00 00 00 00 0 0  
SAG                              ETBCIS     USER-INFO
 2 0 16 86400 0 31647 0 00 00 00 00 0 0                  
SAG                              ETBCIS     CMD      
 6 0 16 86400 0 31647 0 00 00 00 00 0 0

Example 2

Your own profile: MYPROF

//ETBINFO EXEC PGM=ETBINFO,PARM=('/-b ETB001::NET -d SERVICE ',
//         '-p "//''EXX960.JOBS(MYPROF)''" -xUID')

Note:
In this case, MYPROF contains:%4.4SERVERCLASS %SERVERNAME

The following list is displayed:

ACLA    ASERVER
BCLA    BSERVER
CCLA    CSERVER

Sample Profiles for ETBINFO

You can find the sample profiles for ETBINFO in your EXB source library.

Format String

The format string, if specified, will override the use of a profile. The format string is built like a printf() in C language. The string must be enclosed in quotation marks. You can specify the columns by using a "%" and the column name. The column name must contain letters only. Numeric characters are not allowed. You can specify the length of column output by using a format precision, as in the ANSI-C printf() function. The column name must be followed by a blank. For example:

etbinfo -b ETB001 - BROKER -f "%12.12CPLATNAME   %NUM-SERVER      %NUM-CLIENT"

which produces the following output, for example:

MVS/SP 7.04 30 100

You can also use an arbitrary column separator, which can be any character other than "%". You can use \n for a new line in the output and \t for a tabulator in the format string or profile. For example:

etbinfo -b ETB001 -d SERVER -f "UserID: %5.5USER-ID Token: %5.5TOKEN"

which produces:

UserID: HUGO  Token: MYTOK
UserID: EGON  Token: 
UserID: HELMU Token: Helmu

If you want to structure your output a little more, you can operate with the \n or \t character. For example:

etbinfo -b ETB001 -d SERVICE -f  "Class:%5.5SERVER-CLASS \n\tName:%5.5SERVER-NAME \n\tService:%5.5SERVICE"

which produces:

Class:DATAB
    Name:DB10
    Service:Admin
Class:PRINT
    Name:LPT1
    Service:PRINT
...

ETBCMD

Allows the user to take actions - for example purge a unit of work, stop a server, shut down a Broker - against EntireX Broker.

• Running the Command-line Utility

• Command-line Parameters

• Command-line Parameters from File

• List of Commands and Objects

• Examples

Running the Command-line Utility

In a z/OS environment, run the ETBCMD command-line utility like this:

//ETBCMD  EXEC PGM=ETBCMD,
// PARM=('ENVAR(''ETB_STUBLOG=0'')/ -bbrokerid ',
//       '-dBROKER -c... -xuid -ypwd')
//STEPLIB  DD   DISP=SHR,DSN=< EXB-load-lib >
//         DD   DISP=SHR,DSN=< EXX-load-lib >
//         DD   DISP=SHR,DSN=< WAL-load-lib >
//TRACE1   DD   SYSOUT=*                               stublog
//SYSOUT   DD   SYSOUT=*                               stderr
//SYSPRINT DD   SYSOUT=*                               stdout
//

The SVC number specified in the ADARUN parameter must match the SVC number used for the target Broker ID.

Command-line Parameters

The table below explains the command-line parameters. All entries in the Option column are case-sensitive.

Transport ID Values

This table explains the possible values for parameter transportid:

Command-line Parameters from File

ETBCMD supports an alternative method of passing command-line parameters.

If the DDNAME CMDFILE is allocated, using

//CMDFILE  DD  DISP=SHR,DSN=pds(member)

and no command-line parameters are specified in the EXEC instruction, the content of the allocated member is evaluated. See sample member below (the apostrophes are included to show the record format (LRECL 80):

'-blocalhost:3930:TCP                                                            '
'-dBROKER                                                                        '

Caution:
Make sure CMDFILE does not contain line numbers in columns 73-80. If line nubmers are present, arguments are not passed correctly.

List of Commands and Objects

This table lists the available commands and the objects to which they can be applied.

Examples

ETBSRV

The broker command-line utility etbsrv monitors and controls all local brokers; remote brokers can also be monitored.

• Starting a Broker

• Pinging a Broker

• Pinging an RPC Server

• Restarting a Broker

• Stopping a Broker

• Enabling EntireX Security

• Disabling EntireX Security

Starting a Broker

Use command BROKER START to start a specified broker:

ETBSRV BROKER START "ETB001"

Pinging a Broker

Use command BROKER PING to display the status of a specified local or remote broker. Return code 0 means the broker is running; any other value means the broker has stopped. See Component Return Codes in EntireX. Example:

ETBSRV BROKER PING "ETB001"

Enter the command without specifying a broker to display the status of all brokers.

The information is the same as displayed using System Management Hub.

Pinging an RPC Server

Use command BROKER PINGRPC <brokerid> <class/server/service> to display the status of a specified RPC server. Return code 0 means the RPC server is running; any other value means the RPC server has stopped. See Component Return Codes in EntireX. Example:

ETBSRV BROKER PINGRPC "ETB001" "SAG/ETBCIS/RPCCIS"

The information is the same as displayed using System Management Hub.

Restarting a Broker

Use command ETBSRV BROKER RESTART to stop and restart a specified broker. Example:

BROKER RESTART "ETB001"

Stopping a Broker

Use command BROKER STOP to stop a local broker. Example:

ETBSRV BROKER STOP "ETB001"

Enabling EntireX Security

Activate security with command ETBSRV SECURITY ENABLE; once activated, security can only be deactivated with command SECURITY DISABLE.

To enable automatic scripts to execute administration service commands without having to enter a password, set the option TRUSTED-USER=YES when administration service security is activated.

ETBSRV SECURITY ENABLE TRUSTED-USER=YES

Disabling EntireX Security

Disable security with command ETBSRV SECURITY DISABLE.

www.softwareag.com

Copyright © 1997-2014 Software AG, Darmstadt, Germany.

SEARCH   CONTENTS   |   PDF BOOKS   |   HOME   UP   PREV   NEXT