Strobe Address Space Commands

Starting the StrobeAddress Space

To start a fresh Strobe environment from an operator’s console with no outstanding measurement requests running, issue the following command to the session manager:

START STRxSM

Establishing and Modifying the StrobeEnvironment

To establish the environment, Strobeperforms the following tasks when the address space begins as a started task:

• Loads the programs STRBCLPA and STRBCLPB into the CSA
• Adds the StrobeSVC to the system SVC table
• If the environment is enabled, modifies the attach SVC (SVC 42) address to point to the Strobeattach filter, a routine within STRBCLPA.

StrobeEnvironment

The Strobeenvironment resides in the extended common system area (ECSA). The Strobeenvironment consists of:

• Run-time support modules
• Two entries in the SVC table — one for ATTACH (SVC 42) and one for the StrobeSVC (by default, SVC 67).

Stopping the StrobeAddress Space

Compuware recommends that you use the MVS STOP command whenever possible to stop the Strobeaddress space, and terminate the execute of Strobe. If the results of using the STOP command aren’t as you expected, you should use the MVS CANCEL command, which stops all measurement requests. If using the CANCEL command is unsuccessful, you can issue the MVS TERMINATE command, which leaves the measurement requests active.

You should note that using the CANCEL or TERMINATE command can produce unpredictable results in both the session requester address space, the measured address space or both address spaces because issuing either command causes Strobe to perform many different tasks. Therefore, you should wait a reasonable period of time before you issue any of the commands described in the next three sections.

Stopping Strobewith the STOP Command

To stop the Strobeaddress space, and terminate the execution of Strobe, issue the following command from the operator’s console:

STOP STRxSM

Stopping Strobewith the CANCEL Command

If there are active measurement requests that cannot be QUIT, Compuware recommends that you issue an MVS CANCEL command to Strobe. All session requesters receive a U611 ABEND and Strobewill attempt to end all active measurement requests and terminate.

At times, Strobeis unable to end all active requests and the environment cannot be entirely removed. By default, Strobeattempts to use the environment it finds when it is restarted.

If you want Strobeto create a new environment, you should specify a parameter called ENVNEW with the START command as shown in the example:

START STRxSM,PARM=‘ENVNEW=YES’

Setting ENVNEW to YES causes Strobeto create a new environment. Any measurement requests that had remained with the old environment will now fail.

The default value for ENVNEW is NO, meaning that a new environment is not created and the old one is used during attempts to restart Strobe.

Stopping Strobe with the TERMINATE Command

If you need to bring down Strobewhen measurement sessions are still active and you want to keep them active, issue the following command from an operator’s console:

MODIFY STRxSM,TERMINATE

Active measurement requests will continue to measure. All session requesters will receive a U611 ABEND. Next, to restart, issue the following command:

START STRxSM

By default, the remaining environment is reused, and the measurements remain active. If you find the remaining environment cannot be reused, restart Strobeby issuing the following command:

START STRxSM,PARM=‘ENVNEW=YES’

Stopping a StrobeXCF Group

Use the following procedure to stop a StrobeXCF group:

1. To stop a StrobeXCF group, you first have to end all instances of Strobemeasurement sessions in the group. To do this, you can:
   • Stop submitting new requests and wait for active requests to complete.
   • Use the LIST TYPE=ACTIVE command to determine which measurements are active and then use the SEND command with the QUIT option to terminate them.
     • Prevent queued requests from becoming active by disabling the attach filter with an ENV DISABLE command.
       MODIFY STRxSM,ENV DISABLE

2. Issue the STOP STRxSM command for each instance of Strobethat is to be stopped.

   If you missed any of the active measurement sessions in Step 1 the STOP command is rejected and Strobeissues message STR6411W which lists the request numbers of the active sessions. Stop those sessions with one of the methods listed in step 1 and reissue the STOP command.

Starting and Stopping z/OS UNIX System Services Process Exits

During normal operation, if you specified BPXBATCH=YES in the StrobePARMLIB member, Strobewill use two z/OS UNIX System Services process exits. If these two exits incur a total of 10 ABENDs, Strobedisables its use of the exits and measurement data for z/OS UNIX System Services will not appear in the StrobePerformance Profile.

To restore use of the Strobefor z/OS UNIX System Services process exits, issue the following operator command:

MODIFY STRxSM,ENABLEUSSX

To disable Strobe’s use of the Strobefor z/OS UNIX System Services process exits, issue the following operator command:

MODIFY STRxSM,DISABLEUSSX