Create Graphics Symbol Set (CRTGSS)

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, SC09-1408 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.

Parameters

Keyword	Description	Choices	Notes
GSS	Graphics symbol set	Qualified object name	Required, Positional 1
	Qualifier 1: Graphics symbol set	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, *GSS	Optional, Positional 3
TEXT	Text 'description'	Character value, MBRTXT, BLANK	Optional
AUT	Authority	Name, LIBCRTAUT, CHANGE, ALL, USE, *EXCLUDE	Optional

Top

File (FILE)

Specifies the name and library of the source data file being used to create the symbol set.

This is a required parameter.

The possible library values are:

*CURLIB: The current library for the job is used to store the graphics symbol set. If no library specified as the current library for the job, QGPL is used.
library-name: Specify the library where the graphics symbol set is to be stored.

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

The possible values are:

*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.

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.

The possible values are:

*LIBCRTAUT: The system determines the authority for the object by using the value specified on the Create authority prompt (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 prompt (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.

authorization-list-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

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.