COZZI - Retrieve Object Info (RTVOBJINF)

The COZZI - Retrieve Object Info (RTVOBJINF) command returns the operating system release levels associated with the object. It also returns the number of subobjects in the object. For *PGM, *SRVPGM objects, it returns the number of *MODULEs contained in the object, for *FILE objects it returns the number of members in the file. For DDM *FILE objects it returns the number of members in the associated remote file.

Restrictions:

This command must be run in a CL program.

Parameters

Keyword	Description	Choices	Notes
OBJ	Object	Qualified object name	Required, Positional 1
	Qualifier 1: Object	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
OBJTYPE	Object type	PGM, SRVOBJ, MODULE, FILE	Required, Positional 2
TGTRLS	CL var for TGTRLS (6)	Character value	Optional, Positional 3
CRTRLS	CL var for Created On Rls (6)	Character value	Optional, Positional 4
FORRLS	CL var for Created For Rls (6)	Character value	Optional, Positional 5
CLASS	CL var for CLASS ILE/OPM (3)	Character value	Optional, Positional 6
ENTRIES	CL var for Number of Mbrs/Mods	Decimal number	Optional, Positional 7

Top

Object (OBJ)

Specifies the object whose information is returned.

This is a required parameter.

Qualifier 1: Object

name: Specify the name of program, service program, module or database file whose information is returned.

Object type (OBJTYPE)

Specifies the type object whose information is returned.

This is a required parameter.

*PGM: The object specified on the OBJ parameter is a Program.
*SRVOBJ: The object specified on the OBJ parameter is a Service Program.
*MODULE: The object specified on the OBJ parameter is a Module.
*FILE: The object specified on the OBJ parameter is a database file.

CL var for TGTRLS (TGTRLS)

Returns the earliest release of the operating system on which the object is compatible. For programs, modules and service programs this is the value of the TGTRLS (Target Release) parameter when the object was created. For database files, this is the earliest release on which the file This parameter must be a CL variable TYPE(*CHAR) LEN(6). The returned value is in VxRyMz format. can be used.

CL var for Created On Release (CRTRLS)

The operating system release level on which the object was created is returned to the CL variable specified for this parameter. This parameter must be a CL variable TYPE(*CHAR) LEN(6). The returned value is in VxRyMz format.

CL var for Created For Release (FORRLS)

The operating system release level for which the Object was created. We are unsure what this is supposed to really mean, since both the TGTRLS and CRTRLS provide everything you would need. But IBM keeps this 3rd setting which is almost always the same as the TGTRLS value. This parameter must be a CL variable TYPE(*CHAR) LEN(6). The returned value is in VxRyMz format.

CL var for CLASS ILE/OPM (CLASS)

Receives the operating environment 'ILE' or 'OPM' of the object. This parameter must be a CL variable TYPE(*CHAR) LEN(3).

CL var for Number of Mbrs/Mods (ENTRIES)

Receives the number of modules (if OBJTYPE(*PGM or *SRVPGM) is specified) or the number of members in the file when OBJTYPE(*FILE) is specified. This parameter must be a CL variable TYPE(*DEC) LEN(5 0).