The program identification fill-in enters descriptive information about the program when the program definition is initially created or when it is subsequently modified. All information entered into the program identification fill-in is stored in the Datadictionary. The following screen shows a completed fill-in.
When creating a program definition, the Identification fill-in automatically displays first. When editing an existing program definition, you must issue the IDENTIFICATION (IDE) command to display the Identification fill-in.
=> ------------------------------------------------------------------------------- IDEAL: PGM IDENTIFICATION PGM ADRMRPT (001) TEST SYS: DOC FILL-IN PROGRAM ADRMRPT Created 12/14/94 By JAEGER Last Modified 12/14/94 at 16:56 By JAEGER Last Compiled 12/18/94 at 16:50 Run Status: Private Short Description: Pgm for IDEAL reports Language: IDEAL Target Date __ __ __ Actual Date __ __ __ Description: ________________________________________________________________
The fields on the program identification fill-in are as follows:
Displays the one- to eight-character name assigned to the program definition. CA Ideal initializes the program name to the name entered in the CREATE command or prompter if a name is supplied.
Identifies the initial creation date of the program definition and the user ID of the creator. This information appears only after the program name was entered and accepted. CA Ideal maintains this date.
Identifies the date, time, and user ID of the last edit access. The field is blank until the program definition or an EDIT PGM command accesses it. The information appears only after the program name was entered and accepted. CA Ideal maintains this data.
Identifies the date and time of the last program compilation.
For a CA Ideal program only, an indication of how the program is retained in memory while it is running. Possible values are SHARED, PRIVATE, or RESIDENT. The CA Ideal administrator determines the Run Status of a program. The default for newly created programs is PRIVATE. This line is omitted for non‑Ideal programs. This does not apply to programs in load module format. For more information, see the Administration Guide.
Displays a brief description of the program definition the user entered. This is always in mixed case, regardless of the SET EDIT case specification.
For a non-Ideal subprogram only, indicates whether to release the subprogram and load a new copy each time the subprogram is called in batch. When a new copy is loaded, the local data in the non-Ideal subprogram is reset to initial values on each call.
Enter Y for a new copy or N for no new copy. The default is N (do not release the program after each call). If you change this option, you must recompile all calling programs before they can run. This line is omitted for CA Ideal programs.
Indicates whether the subprogram performs database additions, changes, or deletions for CA Datacom/DB or any SQL access for DB2. Enter Y or N.
CA Ideal uses this information for CHECKPOINT/ROLLBACK processing and, for DB2, for dynamic plan allocation processing.
Displays the language used in the program.
CA Ideal is the default and is used when the program is written in CA Ideal/PDL. The following designations are used:
Specifies Assembler programs.
Specifies PL/1 programs.
Specifies COBOL programs.
You must identify a non-Ideal program to CA Ideal with a CA Ideal fill-in. If it is intended to receive parameters, it must have a CA Ideal parameter definition. However, all other coding and maintenance of a non-Ideal program must be performed outside of CA Ideal.
Displays the date planned for the application to complete.
Displays the date when the application is actually completed.
(Optional) Displays full description of the program definition, up to five lines long.
The program resources fill-in specifies the resources the application uses. These resources can include dataviews, panels, reports, and subprograms.
When a CA Ideal user enters the Resource Editor, the related entities from Datadictionary are copied into a VLS member. At the end of the edit, Datadictionary is updated and the VLS member is deleted.
If there are errors, the CA Ideal user is notified and cannot leave edit until he fixes the errors or presses the Clear key to abandon the change completely.
To access the resources fill-in for the current program definition, issue the RESOURCES (RES) command.
After resources are specified, the next time the fill-in displays, the entries are ordered alphabetically by entity type. In each entity type, the entries are ordered alphanumerically by name.
The information that identifies program resources is stored in the Datadictionary. CA Ideal uses it for reports and to ensure that the program uses only resources for which it is authorized.
The resources of a program do not have to exist when they are entered in the resource fill-in. When these resources eventually are created, they automatically are associated with all programs that have named them as resources.
After the production version of a CA Ideal subprogram is specified as a resource of a program, the program always uses the production version of that subprogram-even if a different version becomes the production version.
You can use a test version of a subprogram in place of a production subprogram when running a production application by using the ASSIGN PROGRAM VERSION command. For more information about ASSIGN PROGRAM VERSION command, see the Programming Reference Guide.
The following screen shows the program resources fill-in. A completed fill-in follows the description of the individual fields.
=> ------------------------------------------------------------------------------- IDEAL: Resource Edit Panel PGM TEST (001) TEST SYS: DOC FILL-IN Command Type Name of DVW/PGM/PNL or RPT Version System Qual? ====== === ========== T O P =============== ==== === = ...... ...... ...... ...... ...... ...... ...... ...... ====== === ======= B O T T O M ============ ==== === =
The components of the program resources fill-in are:
Displays the type of resource. Valid entries are DVW, PNL, PGM, and RPT.
Displays the 1- to 32-character name of a dataview or the one- to eight-character name of a program, panel, or report. If the resource is a dataview, you can specify the authorization ID with the object name, for example, IDEALDS.CUSTOMER.
Identifies the one- to four-character version of the resource. You can specify versions as follows:
Specifies the production version of the resource.
Specifies the version number assigned to the resource when it was defined
Specifies the test status version number assigned to the dataview in the Datadictionary for modeled dataviews in TEST status.
If version is not specified for a dataview, the current setting of the SET DATAVIEW VERSION command determines the version used when the program is compiled.
The one- to three-character system ID for the system where the panel, report, or program belongs. If the system is not entered, the current system (the system of the program being defined) is used.
Y (Default)-Qualify the SQL object name associated with this dataview using the authorization ID specified in the Name field. The object name is qualified in:
N-Generate the SQL object name without qualification. This option lets you access an SQL object other than the one used to catalog the dataview by giving both objects the same table and view name, but different qualifiers. The tables should have the same structure.
SQL objects can be explicitly qualified in embedded SQL. An explicit qualifier is used even if N is specified here. An ASSIGN AUTHORIZATION command can override the authorization ID specified here.
For more information about embedded SQL and the ASSIGN AUTHORIZATION command, see the Programming Reference Guide.
=> ------------------------------------------------------------------------------- IDEAL: Resource Edit Panel PGM TEST (001) TEST SYS: DOC FILL-IN Command Type Name of DVW/PGM/PNL or RPT Version System Qual? ====== === ========== T O P =============== ==== === = ...... DVW IDEALDS.CUSTOMER Y ...... PNL CUSTPNL 001 CUS ...... PGM STDERROR PROD $ID ...... RPT CUSTLIST 002 ====== === ======= B O T T O M ============ ==== === =
The DISPLAY INDEX PROGRAM command or equivalent DISPLAY INDEX prompter displays the names and status of all occurrences of program definitions in the current system. To display an index of program resources, use the RELATED TO clause of the DISPLAY INDEX command, as follows:
For the complete syntax of the DISPLAY INDEX command, see the Command Reference Guide.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|