CRTGSS (Create Graphics Symbol Set)

CRTGSS Command syntax diagram

 

Purpose

The Create Graphics Symbol Set (CRTGSS) command creates a graphics symbol set object from a physical file that contains symbol set data. Depending upon the contents of the file, the CRTGSS command creates either a vector symbol set (mode 3 graphics characters) or an image symbol set (mode 2 graphics characters).

The symbol set object can be used in a graphical data display manager (GDDM*) or presentation graphics routines (PGR) graphics application program or in a Business Graphics Utility chart as an alternative to an IBM-supplied graphics symbol set. More information on the Business Graphics Utility is in the BGU User's Guide and Reference book.

Restriction: A physical file used with this command must contain records with no less than 80 bytes and no more than 400 bytes, and a source file must contain no less than 92 bytes and no more than 412 bytes. The contents of the file must be in symbol set format.

 

Required Parameters

GSS

Specifies the qualified name of the graphics symbol set being created. Graphics symbol set names cannot exceed eight characters.

The name of the graphics symbol set can be qualified by one of the following library values:

*CURLIB: The graphics symbol set is created in the current library for the job. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library where the graphics symbol set is created.

graphics-symbol-set-name: Specify the name of the graphics symbol set being created.

FILE

Specifies the qualified name of the file being used to create the symbol set.

The name of the file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

file-name: Specify the name of the file being used to create the graphics symbol set.

 

Optional Parameters

MBR

Specifies the name of the file member being used to create the symbol set.

*GSS: The name of the file member that contains the input data is the same as the symbol set being created.

member-name: Specify the name of the file member that contains the symbol set input data.

AUT

Specifies the authority given to users who do not have specific authority to the graphics symbol set, who are not on an authorization list, and whose user group has no specific authority to the graphics symbol set. More information on this parameter is in Commonly used parameters.

*LIBCRTAUT: The public authority for the graphics symbol set is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the graphics symbol set). The public authority is determined when the graphics symbol set is created. If the CRTAUT value for the library changes after the graphics symbol set is created, the new value does 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 authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 graphics symbol set.

*USE: The user can perform basic operations on the graphics symbol set, such as running a program or reading a file. The user cannot change the graphics symbol set. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the graphics symbol set.

authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the symbol set. More information on this parameter is in Commonly used parameters.

*MBRTXT: The text is taken from the file member being used to create the symbol set.

*BLANK: No text is specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Examples for CRTGSS

Example 1: Creating Set With Same Name as Source File

CRTGSS   GSS(GSSLIB/ADMVARP)  FILE(GSSLIB/ADMVARP)

This command creates a symbol set of the same name and in the same library as the source file.

Example 2: Creating Set From Different Library

CRTGSS   GSS(*CURLIB/VECTOR1)  FILE(GSSLIB/QDATASRC)
  MBR(SCHEM)  AUT(*ALL)  TEXT('Schematic vector symbols')

This command creates a symbol set named VECTOR1 in the QGPL library from member SCHEM in file QDATASRC in library GSSLIB. The public has complete authority over the symbol set. Despite the fact that the symbol set data is stored in source physical file QDATASRC, it cannot be edited or shown by the source entry utility (SEU) because some of the contents of the symbol set data cannot be shown.

Additional Considerations

To use the System/370 symbol sets in iSeries OS/400 system Graphics, you must transport the source data from the System/370 system to the iSeries 400, and then process the CRTGSS command to convert the symbol set source data into an iSeries 400 *GSS object type.

Because System/370 symbol set source data usually has a length of 400, some communications links between the iSeries 400 and System/370 system require that the source data be deblocked into 80-byte records before being sent to the iSeries 400. Other links allow the source data to remain in 400-byte records. However, the CRTGSS command accepts source data with record lengths in the range of 80 through 400 bytes. Symbol set source data with a record length of 400 can be sent back to the System/370 system for modifications, if necessary, while 80-byte data requires blocking again before the symbol editors will accept it.

Symbol set source data can be placed into a physical file of either type *DATA or *SRC. Type *SRC data cannot be edited or browsed, and the record length of the file must be 12 bytes longer than the source data placed into it, to allow for the 12-byte sequence number fields associated with *SRC files. Therefore, the allowable record length range is 92 through 412 bytes for type *SRC files.

Once the symbol set source data is contained as a member in an iSeries 400 database file, it can be used to create a symbol set object (object type *GSS) in the CRTGSS command.

More information on the use of the CRTGSS command and the formats for vector and image symbol set database source files is in the Printer Device Programming book.

Error messages for CRTGSS

*ESCAPE Messages

CPF8660

Symbol set &1 not created in library &2.