IMS System Definition Macros


The IMS system definition macros change from release to release of IMS. See a specific version of IMS Installation Volume 2: System Definition and Tailoring for version-specific details about the system definition macros. The IMS Version 9 system definition macros are briefly summarized here:

APPLCTN

The APPLCTN macro allows you to define the program resource requirements for application programs that run under the control of the IMS DB/DC environment, as well as for applications that access databases through DBCTL. An APPLCTN macro combined with one or more TRANSACT macros defines the scheduling and resource requirements for an application program. Using the APPLCTN macro, you only describe programs that operate in message processing regions, Fast Path message-driven program regions, batch message processing regions, or CCTL threads. You also use the APPLCTN macro to describe application programs that operate in batch processing regions. When defining an IMS data communication system, at least one APPLCTN macro is required.

BUFPOOLS

The BUFPOOLS macro specifies default storage buffer pool sizes for the DB/DC and DBCTL environments. The storage buffer pool sizes specified are used unless otherwise expressly stated for that buffer or pool at control program execution time for an online system.

COMM

The COMM macro specifies general communication requirements that are not associated with any particular terminal type. The COMM macro is always required for terminal types that are supported by VTAM, and might also be required to specify additional system options, such as support for MFS on the master terminal.

CONFIG

The CONFIG macro statement provides the configuration for a switched 3275 terminal. Because the configuration provided by the CONFIG macro is referenced when the named 3275 dials into IMS, differently configured 3275 terminals can use the same communication line. All CONFIG macro statements must be between the LINEGRP macro and the LINE macros. LINE macros can refer to named CONFIG macros defined previously in this line group or in previously defined line groups.

CTLUNIT

The CTLUNIT macro specifies 2848, 2972, and 3271 control unit characteristics. The CTLUNIT macro is valid only for 3270 remote line groups.

DATABASE

The DATABASE macro defines the set of physical databases that IMS manages. One DATABASE macro statement must be specified for each HSAM, HISAM, HDAM, or PHDAM database. Two DATABASE macro statements are required for each HIDAM or PHIDAM database: one for the INDEX DBD and one for the HIDAM or PHIDAM DBD. One DATABASE macro instruction must be included for each secondary index database that refers to any database that is defined to the online system. For Fast Path, a DATABASE macro statement must be included for each main storage database (MSDB) and data entry database (DEDB) to be processed.

FPCTRL

The FPCTRL macro defines the IMS Fast Path options of the IMS control program, and the DBCTL environment. The FPCTRL macro is ignored when the IMSCTRL statement specifies that only a BATCH or MSVERIFY system definition is to be performed.

IDLIST

The IDLIST macro statement is used to create a terminal security list for switched 3275s.

IMSCTF

Defines additional options and system parameters under which IMS is to operate.

IMSCTRL

The IMSCTRL macro statement describes the basic IMS control program options, the z/OS system configuration under which IMS is to execute, and the type of IMS system definition to be performed.

The IMSCTRL macro instruction must be the first statement of the system definition control statements.

IMSGEN

IMSGEN specifies the assembler and binder data sets and options, and the system definition output options and features.

The IMSGEN macro must be the last IMS system definition macro, and it must be followed by an assembler END statement.

LINE

The LINE macro provides the address and characteristics of one line in the line group specified by the LINEGRP statement. The LINE macro describes both switched and nonswitched communication lines to IMS.

LINEGRP

The LINEGRP macro defines the beginning of a set of macro instructions that describe the user's telecommunications system.

MSGQUEUE

The MSGQUEUE macro defines the characteristics of the three message queue data sets: QBLKS, SHMSG, and LGMSG. The information you specify in this macro is also used in a shared-queues environment. The MSGQUEUE macro is required for all DB/DC and DCCTL systems.

MSLINK

The MSLINK macro defines a logical link to another system.

MSNAME

The MSNAME macro provides a name for the remote and local system identifications that it represents.

MSPLINK

The MSPLINK macro defines a physical MSC link.

NAME

The NAME macro defines a logical terminal name (LTERM) that is associated with a physical terminal. You might need to provide a NAME macro for the following macros: TERMINAL, SUBPOOL, MSNAME.

POOL

The POOL macro describes a pool of logical terminals that are associated with a set of switched communication lines.

RTCODE

The RTCODE macro is used one or more times with the APPLCTN macro that defines a Fast Path application program. The RTCODE macro specifies the routing codes that identify the program named in the preceding APPLCTN macro. A TRANSACT macro that specifies an IMS Fast Path-exclusive transaction builds an internal RTCODE macro with a routing code that is identical to the transaction code.

SECURITY

The SECURITY macro specifies optional security features that are in effect during IMS execution unless they are overridden during system initialization.

STATION

The STATION macro describes the physical and logical characteristics of System/3 or System/7 remote intelligent stations.

SUBPOOL

The SUBPOOL macro, when used in a VTAM macro set, is a delimiter between groups of NAME macros that create LU 6.1 LTERM subpools.

When the SUBPOOL macro is used in a switched communication device macro set, the SUBPOOL macro defines a set of logical terminals.

TERMINAL

The TERMINAL macro defines physical and logical characteristics of VTAM nodes and non-VTAM communication terminals.

TRANSACT

The TRANSACT macro is used one or more times with each APPLCTN macro to identify transactions as IMS exclusive, IMS Fast Path potential, or IMS Fast Path exclusive. The TRANSACT macro specifies the transaction codes that cause the application program named in the preceding APPLCTN macro to be scheduled for execution in an IMS message processing region. The TRANSACT macro also provides the IMS control program with information that influences the application program scheduling algorithm.

TYPE

The TYPE macro defines the beginning of a set of communication terminals and logical terminal description macros that include the TERMINAL and NAME macros. The TYPE macro begins a description of one set, which contains one or more terminals of the same type. The TYPE macro defines terminals attached to IMS through VTAM and is equivalent to the LINEGRP and LINE macro set that is used to define terminals attached to IMS by means other than VTAM.

VTAMPOOL

The VTAMPOOL macro, required for parallel session support, begins the definition of the LU 6.1 LTERM subpools.



Introduction to IMS. Your Complete Guide to IBM's Information Management System
An Introduction to IMS: Your Complete Guide to IBMs Information Management System
ISBN: 0131856715
EAN: 2147483647
Year: 2003
Pages: 226

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net