Create Font Resource (CRTFNTRSC)

The Create Font Resources (CRTFNTRSC) command creates a font resource object from a physical file. The physical file contains the font resource information. The font resource information, can, for example, come from an S/370 host system and be in the Systems Application Architecture* (SAA) format. Depending on the type of information processed by the CRTFNTRSC command, the results are either a font character set, a code page, or a coded font.

Parameters

Keyword Description Choices Notes
FNTRSC Font resource Qualified object name Required, Positional 1
Qualifier 1: Font resource Name
Qualifier 2: Library Name, *CURLIB
FILE File Qualified object name Required, Positional 2
Qualifier 1: File Name
Qualifier 2: Library Name, *LIBL, *CURLIB
MBR Member Name, *FNTRSC Optional, Positional 3
FNTCAPTURE Font capture *FILE, *NO, *YES Optional
TEXT Text 'description' Character value, *MBRTXT, *BLANK Optional
REPLACE Replace font resource *YES, *NO Optional
AUT Authority Name, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE Optional

Font resource (FNTRSC)

Specifies the font resource being created.

This is a required parameter.

Qualifier 1: Font resource

name
Specify the name of the font resource.

Qualifier 2: Library

*CURLIB
The current library for the job is used to store the font resource. If no library is specified as the current library for the job, QGPL is used.
name
Specify the library where you want to store the font resource.

Source file (FILE)

Specifies the file containing the font resource sent to this system.

This is a required parameter.

Qualifier 1: Font resource

name
Specify the name of the file to be used.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the file. If no library is specified as the current library for the job, QGPL is used.
name
Specify the library where the file name is located.

Source file member (MBR)

Specifies the file member containing the font resource records.

*FNTRSC
The name of the file member is specified in the Font resource (FNTRSC) parameter of this command.
name
Specify the name of the member in the file specified by the Source file (FILE) parameter.

Font capture (FNTCAPTURE)

Specifies whether the font character set or code page is to be marked as eligible for font capturing. Fonts and code pages that are marked with FNTCAPTURE(*YES) are eligible to be captured after downloading on printers that support font capturing. This allows IPDS printers that support font capturing to dynamically capture or cache a host downloaded font which has been marked with font capture *YES. The captured font then appears to PSF like a printer resident font and remains in the printer even after it has be powered off and then on again. Printing performance is improved by eliminating subsequent font downloads to the printer. Caution must be used when marking security sensitive fonts as FNTCAPTURE(*YES). There exists a possibility that someone could access the captured font in the printer from another print job on the same system or another print job on a different system if the printer is LAN attached. To use a host font referenced in a print job, you must have authority to the font object and its library regardless if it has been captured in the printer or not. In addition to marking the font character set and code page, you must also activate font capturing on the printer you are using. To activate font capturing on an IPDS printer, you must specify FNTCAPTURE(*YES) on the CRTPSFCFG or CHGPSFCFG command.

Notes:

*FILE
The font capture information stored in the font source is used to mark the font. If no information is found, then *NO is assumed.
*YES
The font character set or code page is eligible to be captured after downloading to the printer. If the printer does not support font capturing, this information is ignored and the font is downloaded.
*NO
The font character set or code page is not eligible for font capturing. It will also be downloaded to the printer.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*MBRTXT
The text is taken from the file member being used to create the font resource. You can add or change text for a database source member by using the Source Entry Utility (STRSEU) command, or by using either the Add Physical File Member (ADDPFM) command or the Change Physical File Member (CHGPFM) command. If the file is an inline file or a device file, the text is blank.
*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.

Replace font resource (REPLACE)

Specifies whether an existing font resource with the same name as the one being created is replaced.

*YES
The existing font resource is replaced.
*NO
If a font resource with same name exists on the system, the create operation fails. The existing font resource is not replaced.

Authority (AUT)

Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.

*LIBCRTAUT
The system determines the authority for the object by using the value specified on the Create authority (CRTAUT) parameter on the Create Library command (CRTLIB) for the library containing the object to be created. If the value specified on the Create authority (CRTAUT) parameter is changed, the new value will not affect any existing objects.
*CHANGE
The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
*ALL
The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
*USE
The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
*EXCLUDE
The user cannot access the object.
name
Specify the name of an authorization list. Users included on the authorization list are granted authority to the object as specified by the list. The authorization list must exist when the object is created.

Examples 

CRTFNTRSC   FNTRSC(MYLIB/GOTHIC12)  FILE(*LIBL/FONTRSCS)
            MBR(*FNTRSC)  AUT(*USE)
            TEXT('Gothic Font 12 Pitch')

This command creates font resource GOTHIC12 in MYLIB. Source file FONTRSCS, in the user's library list, with member GOTHIC12 is used as input. Specifying *USE for the AUT parameter allows other users to access GOTHIC12, but not to change it. The text describes the font resource.

Error messages

*ESCAPE Messages

CPF2283
Authorization list &1 does not exist.
CPF8056
File &1 in &2 not a physical file.
CPF88C1
Printer resource type &1 &2 was not created in library &3.
CPF9809
Library &1 cannot be accessed.
CPF9810
Library &1 not found.
CPF9812
File &1 in library &2 not found.
CPF9822
Not authorized to file &1 in library &2.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9847
Error occurred while closing file &1 in library &2.
CPF9870
Object &2 type *&5 already exists in library &3.