IBM Tivoli NetView for z/OS Programming: Pipes - IBM notice

Full-Screen Automation
316 Programming: Pipes
/* REPTALRM: REXX procedure to report the alarm thresholds of a modem. */
’ATTACH MDMCNFG ID=NCP1,STATION=TERM4,MODEM=REMOTE,BROWSE=CONFIG’
’PIPE (NAME GETCONFG)’,
’| VET NEXT ROWS’,
’| CORRWAIT 60’,
’| SEPARATE’,
’| NOT TOSTRING /ALARM THRESHOLDS/’,
’| TOSTRING NOINCL /HIT ENTER/’,
’| CONSOLE’
Figure 15. Simple Full-Screen Automation Example: REPTALRM
Starting a NetView Application
The first step in full-screen automation is starting the application. In Figure 15 on
page 316 the ATTACH command starts the command MDMCNFG. All parameters
that are valid on MDMCNFG can be included on the ATTACH command. In this
case, MDMCNFG requests changeable configuration information for the remote
modem on the link connecting NCP1 and TERM4.
The ATTACH command in this example starts MDMCNFG and makes the panel
shown in Figure 16 available as a virtual screen.
Note: A virtual screen is not physically displayed on a hardware screen. Instead, it
is a way to make the data, which is displayed on a hardware screen,
available to a full-screen automation program. For more information on
virtual screens, see “Virtual OSTs” on page 318.
NETVIEW NCF01 OPER1 11/16/10 11:55:13
* BROWSE CHANGEABLE 7861 CONFIGURATION PARAMETERS *
ID = NCP1 STATION = TERM4 MODEM = REMOTE LEVEL = 1
BASIC MODEM CONFIGURATION
SPEED CONTROL MODE M (M=MODEM, D=DTE)
TRAINING SEQUENCE L (L=LONG, S=SHORT)
CONFIGURATION P (M=MULTI-POINT, P=POINT TO POINT)
NETWORK FUNCTION C (C=CONTROL/PRIMARY, S=SECONDARY)
ANTISTREAMING N (Y=YES, N=NO)
TRANSMIT CLOCK OPTION E (I=INTERNAL, E=EXTERNAL, R=RECEIVE)
COMPLEMENTARY RFS DELAY 0 MS (0 TO 250 IN 10MS INCREMENTS)
DEFAULT SPEED F (F=FULL, B=BACKUP)
LOCAL LOOP BACK WRAP N (Y=YES, N=NO)
CUSTOMER INFORMATION (10 CHARACTER LIMIT)
ALARM THRESHOLDS
RECEIVE LEVEL THRESHOLD -43 DBM (-43 to 0)
IMPULSE HITS THRESHOLD 21 (0 TO 63)
LINE QUALITY THRESHOLD 10 (0 TO 14)
HIT ENTER TO END COMMAND
Figure 16. Browse Changeable Configuration Panel
Interacting with and Terminating a NetView Application
The following example shows how to return to the console the following four lines
on the MDMCNFG panel followed by a blank line:
ALARM THRESHOLDS
RECEIVE LEVEL THRESHOLD -43 DBM (-43 to 0)
IMPULSE HITS THRESHOLD 21 (0 TO 63)
LINE QUALITY THRESHOLD 10 (0 TO 14)