|
|
|
The Unrecog. Procedure Entity section of the REXX Analyzer report identifies the procedures that contain only one unrecognized entity. For each procedure, the section identifies the NetView REXX command, function, or pipe stage that is not recognized. It also displays the usage of the procedures if the NetView Details (REXX usage) fields were filled in on the Analysis Criteria panel. It indicates the number of hits weighted by time for a procedure, from the Tivoli NetView SHOW MEMSTAT command.
All this information helps to plan the recoding effort to bring the greatest immediate rewards. If many procedures have the same single unrecognized entity, then learning how to replace the use of that one entity results in many working procedures. Similarly, if there are procedures with high usage figures, they also need to be concentrated on early.
Some unrecognized entities can be replaced by equivalent CA NetMaster facilities and do not require extensive code updates. In other cases, they do require extensive code updates.
Sometimes, updates involve updating the REXX code. In a few cases, the procedure will need the facilities of NCL.
The REXX Analysis report shows that of Black Lion Telecom’s 200 NetView REXX procedures, 70 contain only a single unrecognized entity.
The report shows that the most frequent unrecognized entity is the Tivoli NetView TRAP command, which is typical for most migrations.
Example: Replace TRAP Command
In Tivoli NetView, you can use the PIPE command, or the TRAP and MSGREAD commands to process command output in REXX.
Procedures that use TRAP, WAIT, and MSGREAD tend to be older procedures that were developed before the availability of the corresponding pipe stages. IBM recommends against further use of superseded commands like these.
The following NetView REXX procedure uses the TRAP and MSGREAD commands:
/* REXX */
/* Simple example on how to replace a TRAP/MSGREAD code segment */
/* in a NetMaster NetView emulation REXX procedure */
/* */
/*--------------------------------------------------------------------*/
/* Part 1 - The NetView REXX procedure */
/* */
/* a) Issue the TRAP command */
/* b) Issue the DATE command - The expected message is: */
/* CNM359I DATE : TIME = hh:mm DATE = mm/dd/yy */
/* */
/* c) Read message (MSGREAD) */
/* d) Extract and display the current time */
/*--------------------------------------------------------------------*/
"TRAP AND SUPPRESS ONLY MESSAGES CNM359I "
"DATE"
"MSGREAD"
SAY " THE CURRENT TIME IS: "||MSGVAR(5)
SAY " BYE "
This Tivoli NetView procedure produces the following output:
NCCF Tivoli NetView CNM01 USER01 01/04/06 10:01:06 * CNM01 MYPROC C CNM01 THE CURRENT TIME IS: 10:01 C CNM01 BYE
The following CA NetMaster procedure that replaces the Tivoli NetView procedure does not use the TRAP command:
/* REXX */ /* Simple example on how to replace a TRAP/MSGREAD code segment */ /* in a NetMaster NetView emulation REXX procedure */ /*--------------------------------------------------------------------*/ /* */ /* Part 2 - The NetMaster NetView Emulation REXX procedure: */ /* */ /* The TRAP, DATE command, MSGREAD and result display have */ /* been replaced by PIPE command: */ /* */ /* a) Issue DATE command via NetView stage */ /* b) Select XND359I message (NetMaster CNM359I equivalent)*/ /* c) Extract the time */ /* d) Display the result */ /* */ /*--------------------------------------------------------------------*/ "PIPE NETVIEW DATE", " |LOC /XND359I/", " |EDIT /THE CURRENT TIME IS:/ NEXT WORD 6", " |CON" SAY "BYE "
This procedure produces the following output:
(20.01)---------- NetMaster Operator Console Services (PROD1) ----------------- PROD1:USERO1 NCCF-like facility active, press PF3 to exit ------------------------------------------------------------------------------- THE CURRENT TIME IS: 20:01 BYE
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |