Example of an Application Making a Request

This section provides an example of how an application that puts a request to TWS Automation is defined in TWS.

The application name is MAINT. This application consists of three operations:

  • Stop RMF on the target system
  • Schedule a batch job
  • Restart RMF on successful completion of the batch job
Figure 1 shows the initial panel in the application creation process.
Figure 1. RMF Maintenance Application Primary Panel in TWS
--------------------------- CREATING AN APPLICATION ---------------------------
Command ===> oper                                                              
                                                                               
Enter/Change data below:                                                       
Enter the RUN command above to select run cycles or enter the OPER command     
to select operations.                                                          
                                                                               
Application:                                                                   
 ID                ===> MAINT___________                                       
 TEXT              ===> RMF Maintenance_________  Descriptive text             
 TYPE              ===> A           A - Application, G - Group definition      
Owner:                                                                         
 ID                ===> SAOPER_TEAM_____                                       
 TEXT              ===> SAOPER Team_____________                               
                                    Descriptive text of application owner      
PRIORITY           ===> 5           A digit 1 to 9 , 1=low, 8=high, 9=urgent   
VALID FROM         ===> 07/12/06    Date in the format YY/MM/DD                
STATUS             ===> A           A - Active, P - Pending                    
AUTHORITY GROUP ID ===> ________    Authorization group ID                     
CALENDAR ID        ===> DEFAULT_________  For calculation of work and free days
GROUP DEFINITION   ===> ________________  Group definition id                  
SMOOTHING FACTOR   ===> ___   LIMIT  ===> ___  Deadline Feedback options       

In Figure 1, certain fields, such as calendar ID, are not used. However, TWS Automation does not preclude the use of normal application and operation functions.

Selecting OPER as a primary command allows the entry of individual operations for this application.

In Figure 2, three operations are defined. The first and third send requests to TWS Automation in the NetView domain that is associated with the NV00 workstation. The second is a batch job named RMFMAINT that performs the batch maintenance tasks.
Figure 2. Operations in the MAINT Application
 --------------------------------- OPERATIONS ----------------- Row 1 to 3 of 3 
 Command ===> text                                             Scroll ===> PAGE 
                                                                                
 Enter/Change data in the rows, and/or enter any of the following               
 row commands:                                                                  
 I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - Delete                       
 S - Select operation details, J - Edit JCL                                     
 Enter the TEXT command above to include operation text in this list, or,       
 enter the GRAPH command to view the list graphically.                          
                                                                                
 Application            : MAINT            RMF maintenance                      
                                                                                
 Row  Oper      Duration  Job name  Internal predecessors           Morepreds   
 cmd  ws   no.  HH.MM.SS                                            -IntExt-    
 '''' NV00 001  00.01.00  RMF_____  ___ ___ ___ ___ ___ ___ ___ ___   0  1      
 '''' CPU1 010  00.10.00  RMFMAINT  005 ___ ___ ___ ___ ___ ___ ___   0  0      
 '''' NV00 015  00.01.00  RMF_____  010 ___ ___ ___ ___ ___ ___ ___   0  0      
 ******************************* Bottom of data ********************************
Selecting TEXT as a primary command allows entry of the operation text. TWS Automation uses the Operation text field to contain the request and up to two optional parameters for operations with the workstation defined for TWS Automation. Figure 3 shows the resulting operations text detail panel.
Figure 3. Operations Text Detail Panel
 --------------------------------- OPERATIONS ----------------- Row 1 to 3 of 3 
 Command ===>                                                  Scroll ===> PAGE 
                                                                                
 Enter/Change data in the rows, and/or enter any of the following               
 row commands:                                                                  
 I(nn) - Insert, R(nn),RR(nn) - Repeat, D(nn),DD - Delete                       
 S - Select operation details, J - Edit JCL                                     
 Enter the PRED command above to include predecessors in this list, or,         
 enter the GRAPH command to view the list graphically.                          
                                                                                
 Application            : MAINT            RMF maintenance                      
                                                                                
 Row  Oper      Duration  Job name  Operation text                              
 cmd  ws   no.  HH.MM.SS                                                        
 '''' DUMY 001  00.01.00  RMF_____  STOP____________________                    
 '''' CPU1 010  00.10.00  RMFMAINT  ________________________                    
 '''' DUMY 015  00.01.00  RMF_____  START___________________                    
 ******************************* Bottom of data ********************************

In the applications, TWS Automation defines TWS requests in a generic manner. Figure 3 shows the MAINT application with the first and last operations defined for the NetView workstation NV00. The requests that are forwarded to the NetView workstation NV00 are STOP and START. These requests are expanded by definitions in the policy database into commands; see Executing TWS Requests with TWS Automation.