Direct Commands

This section describes the direct commands provided by SMA.

Note:
In this section, the term "tape" represents any installation media (e.g. tape and CD-ROM) supported by Software AG. The information provided here applies to the use of any of these media.

Command Description
ADD Add a data set or a new product definition
CLONE Clone an existing environment
COPY Copy an existing environment or generated jobs
DELETE Delete the table entry of a data set or generated jobs
GENERATE Start JCL generation
INSTALL Mark products for installation
LOAD Load SMA table data
MARK Mark data sets as to be copied
MODIFY Set new values for parameters
NATURAL Execute a Natural command
RENAME Rename an existing environment
REPORT Create reports
SET Set parameters and values for subsequent processing
UNLOAD Unload jobs, parameters or skeletons

Entering Direct Commands

Note:
SMA internally uses the notations OS/MVS, VSE/SP, and BS2000 for designating the operating system and default environment. These notations directly correspond to the operating systems z/OS, VSE/ESA or z/VSE, and BS2000/OSD, respectively.

In online dialog mode, direct commands can be entered in the command line at the bottom of each screen. Maximum length is 60 bytes.

In batch mode, direct commands can be provided as input for the program MENU. The maximum length is 80 bytes. To continue over several command lines, use the continuation character (%) which will be replaced by a blank before execution.

The following input in the command line is always valid:

  • a period (.) has the same effect as PF3, that is, control is returned to the previous menu

  • a two-digit number from 01 to 12 has the same effect as the corresponding PF key

Command Syntax

The commands have the following syntax:

function  <object-type>  <object>  

Not all functions are implemented for all object types. See the description of each command for the valid command combinations.

Commands for Dialog Control

The following commands can be used to access a menu function directly without having to return to the main menu first.

Command Menu Invoked
A SMA Administration Menu
A IUPD SMA Administration Menu - Unused Solutions
A LIB-group SMA Administration Menu - Unused Library Groups
A PARAM SMA Administration Menu - Global Parameters
A PRODuct SMA Administration Menu - Unused Products
A PROFile SMA Administration Menu - SMA Profile
A SAVED SMA Administration Menu - Saved Jobs
A TABLoad SMA Administration Menu - Tabload Job
A TAPE SMA Administration Menu - Unused Tapes
E Environment Maintenance Menu
E <name> Environment Maintenance Menu - only the specified environment is displayed
R Reports Menu
T Datasets on Tapes Menu
T PROD Datasets on Tapes Menu - Product Selection List
T VOL Datasets on Tapes Menu - Tape Selection List
Z Library Corrections Menu

Using Direct Commands in Batch Mode

Executing SMA in batch mode may be required when product installation media or work files are used, or when large reports are printed.

All SMA direct commands are also valid in batch mode. The most important commands for working with SMA in batch mode are MODIFY PARAMETER, INSTALL and GENERATE.

The JCL Generator stores the generated JCL in the SMA system file. When SMA is used in batch mode, the same JCL is also written to Natural Workfile 2 so that it can be stored within an operating system file.

Executing SMA in Batch Mode

Start a batch-mode Natural session with the following CMSYNIN input:

  LOGON SYSSMA1
  MENU
  <command> <command-value ... >
  ...         possible further commands  ... 
  FIN

Each command and its corresponding values must be contained on one line. Commands and/or command values must be separated by a blank or a comma.

The GENERATE command must always be the last command.

Example

The following example shows a command sequence for installing products ADA743 and AOS743 from an installation medium.

Input to batch-mode Natural CMSYNIN:

LOGON SYSSMA1
MENU  (see note 1)
LOAD  (see note 2)
SET ENV OS/MVS  (see note 3)
MODIFY PARAMETER LIB-GROUP SAGLIB
MODIFY PARAMETER LIB-GROUP-UNIT 3390
MODIFY PARAMETER LIB-GROUP-VOL SAGDSK
SET-INSTALLED OS/MVS
COPY ENVIRONMENT OS/MVS SAGTEST Test Application Program  (see note 4)
INSTALL ADA743  (see note 5)
INSTALL AOS743
MODIFY PARAMETER SVC 249
MODIFY PARAMETER DBID 25
DELETE JOBS  (see note 6) 
GENERATE  (see note 7)
FIN

Notes:

  1. The SMA batch-mode command processor is invoked.

  2. Load control information into SMA. This command requires that Natural Workfile 1 be assigned to the first data set on an installation medium.

  3. The LIB-GROUP parameters are set to local requirements in the default environment, and these parameter changes are committed immediately.

  4. The default environment OS/MVS is copied to the new customer environment named SAGTEST. This new environment will be the environment used for all subsequent commands.

  5. Products ADA743 and AOS743 are marked as to be installed, and the environment parameters SVC and DBID are set to 249 and 25 respectively.

  6. All stored jobs of previous executions are deleted.

  7. JCL Generator is invoked.