SVC 26 (0A1A)

CATALOG/INDEX/LOCATE macro - is type 4, gets no lock.

Calls module IGC0002F.

GTF data is:

R15 and R0

No applicable data.

R1

Address of the parameter list when a SVC 26 is issued. The parameter list is in the format of a OS/VS CAMLST. The CAMLST macro is used to generate the CAMLST when the CATALOG, INDEX, or LOCATE macro issues the SVC call.

CAMLST Bytes:

-4 - -1	CTGPLXPT		CPL prefix pointer
0	First option byte:
	Bits
	1...		CVOL specified. CVOLs are no longer supported.
	.1..	....	Reserved.
	..1.	....	CATALOG or CATBX specified.
	...1	....	RECAT (re-catalog) specified.
	....	1...	UNCAT or UCATDX specified.
	....	.1..	Reserved.
	....	..1.	LOCATE by TTR specified.
	........	...1	Reserved.
1	Second option byte:
	Bits
	1...	....	Do not allocate CVOL. Note: CVOLs are no longer supported.
	.1..	....	BLDX/CATBX specified.
	..1.	....	BLDG specified.
	...1	....	BLDA specified.
	....	1...	LNKX specified.
	....	.1..	DLTX/UCATDX specified.
	....	..1.	DSCB TTR specified.
	....	...1	DLTA specified.
2	Third option byte:
	Bits
	1...	....	DRPX specified.
	.1..	....	Indicate DELETE option.
	..1.	....	RENAME specified.
	...1	....	SYSZTIOT is enqueued exclusively.
	....	1...	Indicate the EMPTY option.
	....	.11.	Reserved.
	....	...0	The caller supplied a CAMLST.
	....	...1	The caller supplied a CTGPL.
3	Maximum generation count for GDG or zeroes.
4-7	Address of the name or TTR if byte 0, bit 6 is “on”.
8-11	Address of the CVOL volser or zeroes if byte 0, bit 0 is zero. Note: CVOLs are no longer supported.
12-15	a. When cataloging, the address of the volume list. b. Address of an 8-byte area that contains an alias for a high-level index. Note: CVOL must also be specified. c. When performing LNKX, the address of a 10-byte area that contains a 4-byte device code followed by the 6-byte volume serial number of the CVOL to be connected. d. When performing the LOCATE function, the address of a 265-byte work area that must be on a doubleword boundary. If the issuer of LOCATE has a non-zero protect key, then the work area must have a matching storage protect key.
16-19	Address of the DSCB TTR when cataloging it.

CTGPLEXT - CPL extension. The CPL extension contains additional fields that define the catalog management request and its options. It is pointed to by CTGPLXPT of the CPL.

Offset	Bytes/Bits		Field	Description
0 (0)	48		CTGPLEXT	CPL extension.
0 (0)	10		CTGXHDR	Extension header.
0 (0)	6		CTGXID	Extension ID 'CPLEXT'.
6 (6)	2		CTGXVERN	Extension version number.
8 (8)	2		CTGXLEN	Extension length.
10 (A)	2			Reserved.
12 (C)	4		CTGXFLD	Extension fields.
12 (C)	1		CTG2FUNC	Secondary function byte.
13 (D)	1		CTGXFG01	Extension flag byte 1.
	1...	....	CTGNBCS	No BCS update.
	.1..	....	CTGNVVDS	No VVDS update.
	..1.	....	CTGNBCK	No BCS check.
	...1	....	CTGTCOMP	Component name of temporary data set name passed.
	....	1...	CTGTSMS	SMS managed temporary data set.
	....	.111		Reserved.
14 (E)	1		CTGXFG02	Extension flag byte 2.
15 (F)	1		CTGXFG03	Extension flag byte 3.
16 (10)	4		CTGXUCBP	UCB address list pointer.
20 (14)	4		CTNVRBA	NVR RBA.
20 (14)	3		CTGDIRBA	Compressed data/index RBA.
24 (18)	4		CTGLBDAT	Last backup date pointer.
			CTGLRDAT	Last referenced date pointer.
28 (1C)	4		CTGDADSM	DADSM parm list pointer.
32 (20)	12		CTGDIAG	Diagnostic information.
32 (20)	4			Reserved.
36 (24)	4		CTGSFI	Catalog subfunction information.
36 (24)	1		CTGCATPC	Catalog problem code.
37 (25)	1		CTGOPNER	ACBERFLG (open error).
38 (26)	2			Reserved.
40 (28)	4		CTGRPLER	RPL feedback word.
44 (2C)	4			Reserved.

DSN/CI

ccccc....

data set name/control interval name.

VOLIST The volume list is variable in length; format is:

Bytes: Contents
0-1: Number of 12-byte volume list entries to follow.
2-5: UCB device code.
6-11: Volume serial number.
12-13: Reserved.