IBM Version 4 manual Qszrtvpr API, Command B-129, Retriev

ABCPF	\FILE		ðððð2924ðABCABCV3R1Mð
ABCMSG	\MSGF		ðððð2924ðABCABCV3R1Mð
ABC	\CMD		ðððð2924ðABCABCV3R1Mð
ABCPNLGRP	\PNLGRP		ðððð2924ðABCABCV3R1Mð
ABCðð5ð	\PRDDFN		ðððð5ðð1ðABCABCV3R1Mð
ABCðð5ð	\PRDLOD		ðððð5ðð1ðABCABCV3R1Mð
ABCðð29	\PRDLOD		ðððð2924ðABCABCV3R1Mð
ABC	\LIB		ðððð5ðð1ðABCABCV3R1Mð
Before	you	can	build PTFs	for the product, you need to save the
the product		by	using the Save Licensed Program (SAVLICPGM) and Restore
Licensed	Program		(RSTLICPGM)	commands.

Once the product is built, you can do the following:

Ÿ Build PTFs for the product by using the following APIs:

–	Create Program Temporary Fix (QPZCRTFX)
–	Retrieve Program	Temporary	Fix Information (QPZRTVFX)
–	Program Temporary	Fix Exit	Program

ŸUse save, restore, or delete license program (SAVLICPGM, RSTLICPGM,

DLTLICPGM) commands on it.

Ÿ	Retrieve		information	about the	product by	using	the	Retrieve Prod
	tion	(QSZRTVPR) API.
Ÿ	Check	the	product	to verify	the existence	of	libraries,		folders,
	are part of the specified product (Check					Product		Option	(CHKPRDOP
	command).

Note: For examples of the software product example program in additio guages, see “Program for Packaging a Product—Examples” on

page B-129.

Retrieving a File Description			to	a User		Space—ILE	C	Example
The	following		programming example				shows an application that uses a user
as	a receiver			variable		by retrieving a file description to a user
approach is possible only if you								use an HLL that is able to work w
application accepts					the	following		parameters:
Ÿ	User	space		name	and	library
Ÿ	File	name	and	library

ŸRecord format

The following shows the sequence of steps to retrieve a file descr space:

1. The

application

creates

a

user space

to store the data in, ch

space

to

be automatically

extendable, and

retrieves a

pointer to

2. The

application

calls the

Retrieve

File

Description

API

to

retriev

nition

template

and

uses

the user

space

as

the receiver

variable

This

example

uses

an

automatically

extended

user

space

as

the

rece

on a

retrieve API. A

user

space

can

return

a

varying

amount

of

info

depending	on the file description being	retrieved. The user space i
extended	up to 16MB to accommodate the	information	being retrieved.
	Appendix A. Performing	Tasks Using	APIs—ExamplesA-11