Defining and Maintaining Systems › Creating a CA Ideal System

Creating a CA Ideal System

To create the first version of a system definition, enter the command CREATE SYSTEM. The CREATE SYSTEM command displays a blank system definition fill-in. This fill-in establishes the system name, provides identification information about the system, and provides the file names where the system libraries are stored.

A newly created system definition is assigned a version of 1 and is placed in test status. You can edit the new system definition at any subsequent session as long as it remains in test status. Once marked to production status, it is not modifiable.

After the system definition fill-in is presented and you enter a system name, that system becomes the current system definition.

Note: Once created, the system definition is in test status and must be marked to production status before you can access the system.

To display the System Definition Fill-in, shown in the following illustration, enter the command CREATE SYSTEM or select option 2, CREATE, from the System Maintenance Menu.

=>
=>
=>
----------------------------------------------------------------------------
IDEAL: SYSTEM DEFN.         SYS   (001) TEST            SYS: DOC    FILL-IN

System name                _______________
System short identifier    ___
Description                ____________________________________
System user                _______________
Date designed              __ __ __
Date implemented           __ __ __
Application identification _______________

Date created 2/21/06   Last modified ........  at ..:..

SYSTEM LIBRARIES:
  TYPE     FILE NAME

  Source   IDXXXSRC
  Object   IDXXXOBJ
  Panels   IDXXXPNL

Note: Issue “MARK * PROD” or “MARK SYS xxx VER n PROD” to enable SELECT SYSTEM.

The components of the System Definition Fill-in are as follows:

• System name-One- to 15-character name of the system being defined. CA Ideal initializes System name to the name entered on the CREATE command if you entered a name. Once defined on the system definition fill-in, you cannot change the System name. If you want a new System name, delete the system definition and create a new one.
• System short identifier-Three-character system identifier. This three-character identifier becomes an alias for the system in the dictionary facility.

  The System short identifier must be exactly three non-blank characters. The first character must be a letter or national character. The other two characters can be letters, digits, or national characters.

Note: Once defined on the system definition fill-in, you cannot change this identifier. If you want a new System short identifier, delete the system definition and create a new one.

• Description (Optional)-Area where you can provide description of the system being defined (documentation only).
• System user-Area where you can identify the users of the system (documentation only).
• Date designed-Area where you can specify the date the system was designed (documentation only).
• Date implemented-Area where you can specify the date the system was implemented (documentation only).
• Application identification-Area where you can further define the system (documentation only).
• Date created-Initial date of the system definition. The system supplies this date. You cannot modify it.
• Last modified at-Date and time when this system definition was last accessed in edit mode. The format of the time value is hh:mm. The system supplies the date and time. You cannot modify them.
• System libraries-Names of the libraries the system uses for storing source and object modules. Each system can have its own set of libraries or multiple systems can share one or more libraries.
  • Type-Identifies the type of each library in the system as follows:
  • Source libraries-Contain the source of program and report definitions.
  • Object libraries-Contain the object form of program and panel definitions.
  • Panel libraries-Contain panel definitions.
  • File name-For each type, an area where you must supply the file name for each library.

When the System Definition Fill-in is presented as a result of the CREATE SYSTEM command or prompter, CA Ideal provides default file names.

For z/OS, the default names are:

• IDXXXSRC
• IDXXXOBJ
• IDXXXPNL

For VSE, the default names are:

• IDLXXXS
• IDLXXXO
• IDLXXXP

Replace the XXX in each name with the system short identifier to relate the file names to the system definition by convention.

Since each file name becomes a DD statement (in z/OS) or a DLBL statement (in VSE), the names must conform to the rules for formation of ddnames or DLBL names. File names in VSE cannot be longer than seven characters, even though the fill-in provides eight positions (for compatibility with z/OS.)

The source, object, and panel libraries can be in separate files or any combination can be on the same file. The maximum size of a VLS library member is 60,900 blocks (regardless of the blocksize.) Consider this when planning libraries.

You can put each CA Ideal system in its own library or you can put any number of systems in the same library, as shown in the following table.

There are other steps required to allocate, format, and establish new source, object, or panel libraries for a CA Ideal system.

Note: To enable the SELECT SYSTEM command for the newly defined system, issue the command MARK * PROD or MARK SYS xxx VER n PROD.