Space banner This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Task 5 Using the Global Recording facility

This section describes how to use the Global Recording facility.

Important

Roles involved: Session Monitor Installer

Task 5.1 Starting Global Recording task

Use the started task commands and shutdown procedures to control the behavior of the Global Recording facility. Provide your operators with a copy of this section of the space. It explains how to start the Global
Recording started task and how to shut it down.

The TSKMVS task list instructs the system programmer to start the Global Recording task to make the Global Recording facility available to users. If the task is already running, simply review this section before proceeding to the next task.

Tip

This task describes the essential instructions needed to start and stop the Global Recording facility. Complete instructions regarding Global Recording customization and operation are provided in Customizing-after-installation.

Task 5.1.1 To start the Global Recording task

To enable Global Recording activity after each IPL, perform one of the following steps to start the Global Recording started task:

  • Manually start it by issuing the START command described in this section.
  • Ask your MVS Systems Programmer to add the start command to the COMMND00 member to have the MVS Master Scheduler automatically start the task after every IPL.

To start the Global Recording started task, issue the START command on the MVS Console. The syntax of the command is as follows:

S GRTASK,P=parmTo specify more than one parameter, place the comma-delimited parameter string in single quotations as follows:

S GRTASK,P='parm,parm'Control the way the started task behaves with the following start command parameters:

Parameter

Description

EMERGENC

Shuts down Global Recording started task quickly and performs minimal clean up. All VTAM intercepts are preserved but disabled.

STARTUP

Starts up the Global Recording started task

SUFFIX=aaaa

Instructs the Global Recording started task to use a suffix other than 00 when requesting parameter member HSCM. aaaa can be 1 to 4 valid member name characters.

QUIET

Suppresses the following messages when you start up the Global Recording started task:

  • SVMAN601I GLOBAL RECORD SUBSYSTEM IS ALREADY ACTIVE
  • SVMAN602I IT MUST BE SHUTDOWN FOR A STARTUP TO TAKE PLACE
  • SVMAN603I START GLOBAL RECORD USING SHUTDOWN AS THE EXEC PARAMETER
  • SVMAN604I WHEN SHUTDOWN COMPLETES, RESTART NORMALLY

It also suppresses all console messages or TSO TPUT messages, and the following recording request initiation messages:

  • ETGRPX103I GR INITIATED FOR REQUEST nnnnn
  • ETGRPX1041 SIDE A: netida.lunamea SIDE B: netidb.lunameb
  • ETGRPX1051 LOGMODE: llllllll
  • ETGRPX1061 TP: tttttttt

Task 5.1.2 To shut down the Global Recording started task

Shut down the Global Recording started task with either of the following commands:

  • Modify command (F GRTASK,SHUTDOWN)
  • MVS STOP command

It can take several minutes after issuing the command before the Global Recording started task ends completely. If the started task does not end after several minutes, enter the MVS CANCEL command to finish the shutdown.

Warning
  • Never use the MVS FORCE command to shut down the Global Recording started task. An IPL might be required if the FORCE command is used.
  • Always issue a SHUTDOWN or MVS STOP command and wait several minutes for the started task to end completely before issuing a CANCEL command.
  • Do not issue the CANCEL command more than once. An IPL might be required if the CANCEL command is issued more than once.
  • The started task termination and cleanup activity are bypassed if you use the FORCE command or issue the CANCEL command more than once.
  • If, for some reason, you use the FORCE command or issue the CANCEL command more than once, use the START command with the SHUTDOWN parameter to clean up the data areas used by Global Recording.
    S GRTASK,P=SHUTDOWN
    If this technique is not successful, an IPL might be required.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*