GPPW - Set Password

Purpose

Use GPPW to assign a password to a resource. The graPHIGS API uses this password to validate the Attach Resource (GPATR) request from other application processes.

The id parameter specifies an identifier that your application assigned to the resource. The graPHIGS API uses the type parameter to identify the type of resource that the id parameter specifies. For example, if the type parameter specifies 1=WORKSTATION , then the graPHIGS API uses the id parameter to specify a workstation identifier (wsid) whose password is set.

Your application must provide this password (as well as the nucleus's resource identifier for the resource) to other applications that you authorize to access the resource. Use the Send Private Message (GPSPMS) subroutine to send this information. The Attach Resource (GPATR) subroutine then uses this information to authorize access to the resource.

For more information about the use of resource passwords and application messages, see The graPHIGS Programming Interface: Understanding Concepts

Parameters

type -- specified by user, fullword integer

Resource type (1=WORKSTATION, 2=STRUCTURE_STORE, 3=IMAGE_BOARD, 4=FONT_DIRECTORY, 5=ARCHIVE_FILE )

id -- specified by user, fullword integer

An identifier of the resource.

pass -- specified by user, fullword integer

Password.

0=None

Only the application that created the resource can access the resource.

-1=All

Any application can access the resource.

Unique Integer

Only applications that supply the password can access the resource.

Error Codes

25

SPECIFIED WORKSTATION DOES NOT EXIST

211

RESOURCE TYPE IS INVALID

214

PASSWORD CANNOT BE CHANGED FROM THIS APPLICATION

220

SPECIFIED ARCHIVE FILE DOES NOT EXIST

222

SPECIFIED STRUCTURE STORE DOES NOT EXIST

232

SPECIFIED IMAGE BOARD DOES NOT EXIST

242

SPECIFIED FONT DIRECTORY DOES NOT EXIST

Related Subroutines

GPATR

Attach Resource

GPSPMS

Send Private Message

RCP code

201341699 (X'0C003B03')