CST-Save Model

This section describes the CST-Save model, which is used to generate the save subprogram for a model. The save subprogram writes the specification parameters to the source buffer.

This section covers the following topics:


Introduction

To read an existing program, your model must have both a save and a read subprogram. The save subprogram must contain a separate WRITE statement for each specification parameter (#PDAX variable). Use the equal sign (=) notation to include the variable contents with the name of the variables. For example:

WRITE(SRC) NOTITLE '=' #PDAX-variable-name

Note:
Use a separate WRITE statement for each component of an array.

For an example of a save subprogram, refer to CUMNS in the SYSCST library.

Parameters for the CST-Save Model

Use the CST-Save model to create the save subprogram. This model has one specification panel, Standard Parameters.

Standard Parameters Panel

  CUGAMA                       CST-Save Subprogram                       CUG-MA1
  Feb 27                       Standard Parameters                        1 of 1
                                                                                
   Module name ........ CXMNS___                                                
   Parameter data area  CXMNPDA_ *                                              
                                                                                
   Title .............. Save ..._________________                               
   Description ........ Save parameter specification ..._______________________ 
                        _______________________________________________________ 
                        _______________________________________________________ 
                        _______________________________________________________ 
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       help  retrn quit                                            userX main

The input fields on the Standard Parameters panel are:

Field Description
Module name Name specified on the Generation main menu. The name of the save subprogram must be alphanumeric and no more than eight characters in length. Use the following naming convention:
CXxxS

where xx uniquely identifies your model.

Parameter data area Name of the parameter data area (PDA) for your model. Natural Construct determines the name of the PDA based on the Module name specified on the Generation main menu. For example, if you enter "CXMNS", Natural Construct assumes the PDA name is CXMNPDA.

Use the following naming convention:

CXxxPDA

where xx uniquely identifies your model.

Title Title for the generated subprogram. The title identifies the subprogram for the List Generated Modules function on the Generation main menu and is used internally for program documentation.
Description Brief description of the subprogram. The description is inserted in the banner at the beginning of the subprogram and is used internally for program documentation.

User Exits for the CST-Save Model

 CSGSAMPL                     CST-Save Subprogram                        CSGSM0 
 Feb 27                            User Exits                            1 of 1 
                                                        
                User Exits             Exists    Sample   Required Conditional  
     -------------------------------- -------- ---------- -------- ------------ 
  _  CHANGE-HISTORY                            Subprogram                       
  _  PARAMETER-DATA                                                             
  _  LOCAL-DATA                                 Example                         
  _  START-OF-PROGRAM                                                           
  X  SAVE-PARAMETERS                           Subprogram    X                  
  _  BEFORE-CHECK-ERROR                         Example                         
  _  ADDITIONAL-INITIALIZATIONS                 Example                         
  _  END-OF-PROGRAM

For information about these user exits, see Supplied User Exits. For information about using the User Exit editor, refer to User Exit Editor, Natural Construct Generation.