Create PDF Map (QPQCRTPM API)


  Required Parameter Group:

1 Qualified PDF map name Input Char(20)
2 Public authority Input Char(10)
3 Text description Input Char(50)
4 Error code I/O Char(*)

  Default Public Authority: *USE

  Threadsafe: Yes

The Create PDF Map (QPQCRTPM) API creates a PDF map.

The PDF map allows you to define mapping entries (using the Add PDF Map Entry (QPQAPME) API) for spooled files you want to be processed after they have been converted to PDF by PSF/400.


Authorities and Locks

Library Authority
*READ and *ADD.


Required Parameter Group

Qualified PDF map name
INPUT; CHAR(20)

The PDF Map you are creating. The qualified PDF Map name has two parts. The first 10 characters contain the PDF Map name.

The second 10 characters contain the name of the library in which the PDF Map is located.

The following special values are allowed:

*CURLIB The job's current library is used to locate the PDF Map. If no library is specified as the current library for the job, the QGPL library is used.

Specify the name of the library where you want to create the PDF Map.


Public authority
INPUT; CHAR(10)

The authority you give to users who do not have specific private or group authority to the PDF map. Once the PDF Map has been created, its public authority stays the same when it is moved to another library or restored from backup media.

The valid values for this parameter are:

*ALL The user can perform all authorized operations on the PDF map.
Authorization list name The PDF map is secured by the specified authorization list, and its public authority is set to *AUTL. The specified authorization list must exist on the system when this API is issued. If the list does not exist, the create process fails, and an error message is returned to the application.
*CHANGE The user has read, add, update, and delete authority for the PDF map and can read the object description.
*EXCLUDE The user cannot access the PDF map in any way.
*LIBCRTAUT The public authority for the PDF map is taken from the CRTAUT value for the target library when the object is created. If the CRTAUT value for the library changes later, that change does not affect PDF mapping objects already created. If the CRTAUT value contains an authorization list name and that authorization list secures an object, do not delete the list. If you do, the next time you call this API with the *LIBCRTAUT parameter, it will fail.
*USE The user can read the object description and contents but cannot change the PDF map.

Text description
INPUT; CHAR(50)

A brief description of the PDF map.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
CPF2143 E Cannot allocate object &1 in &2 type *&3.
CPF2144 E Not authorized to &1 in &2 type *&3.
CPF2283 E Authorization list &1 does not exist.
CPF3CF1 E Error code parameter not valid.
CPF3C36 E Number of parameters, &1, entered for this API was not valid.
CPF5F0A E PDF map &2 not created.
CPF5F0B D Value &1 for authority parameter is not valid.
CPF9810 E Library &1 not found.
CPF9820 E Not authorized to use library &1.
CPF9830 E Cannot assign library &1.
CPF9838 E User profile storage limit exceeded.
CPF9870 E Object &2 type *&5 already exists in library &3.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V5R3

[ Back to top | Print APIs | APIs by category ]