In the object workspace, the BS2000 job variables are shown when you expand the Job Variables folder of an OSD node. Example:

This document covers the following topics:

• Filtering BS2000 Job Variables

• Listing BS2000 Job Variables

• Adding a New BS2000 Job Variable

• Changing the Attributes of a BS2000 Job Variable

• Displaying the Properties of a BS2000 Job Variable

---

Filtering BS2000 Job Variables

Before displaying BS2000 job variables, you can define a filter so that only those job variables are shown which correspond to your filter criteria.

To define a filter

1. In the object workspace, select the Job Variables folder in the appropriate node.

2. Invoke the context menu and choose Filter.

   Or:
   Press F3.

   The following dialog box appears:

   

3. Enter the filter criteria.

   Option	Description
   Job variable	Enter the job variables that are to be shown.
   Password	You do not have to enter a password here just to list the job variables. However, you must enter a password, if you then want to perform read or write operations on a listed job variable, which requires a password. To change a job variable, 2 passwords may be required, one for read and and another one for write. Mainframe Navigation assumes that the entered password is the read password and prompts for the write password, if required. For more information on passwords, see Changing the Attributes of a BS2000 Job Variable.

4. Choose the OK button.

Listing BS2000 Job Variables

The number of objects shown in the list view window depends on whether or not a filter has been defined for the BS2000 job variables (see Filtering BS2000 Job Variables).

To list BS2000 job variables

1. In the object workspace, select the Job Variables folder in the appropriate node.

2. Invoke the context menu and choose List.

   Or:
   Press F8.

   The job variables are shown in the list view window. Example:

   

Adding a New BS2000 Job Variable

You can add a new BS2000 job variable with standard attributes.

To add a New BS2000 job variable

1. In the object workspace, select the Job Variables folder in the appropriate node.

2. Invoke the context menu and choose New.

   Or:
   Press CTRL+N.

   A dialog box appears.

3. Enter the name and the attributes as described in the section Changing the Attributes of a BS2000 Job Variable.

4. Choose the OK button.

Changing the Attributes of a BS2000 Job Variable

You can change attributes the attributes of a job variable, for example, define a password.

To change the attributes of a BS2000 job variable

1. Select a job variable in the object workspace or list view window.

2. Invoke the context menu and choose Change.

   The following dialog box appears:

   

3. Change the desired attributes.

   Option	Description
   Shared file	Yes	Makes the job variable accessible to other users.
   	No	Restricts access to the owner user ID.
   Access type	Write	Allows write access to the specified job variable, which also implicitly includes authorization for read access.
   	Read	Allows read access only.
   Retention period	Enter a number representing a retention period (in days) that is to be assigned to the specified job variable: This means it can neither be modified nor deleted within the specified period of time.
   Read password	Activate this check box to enter or change a password that protects the job variable against unauthorized read accesses.
   	New password	Enter new read password in this field.
   	Confirmation	Confirm the new read password in this field.
   Write password	Activate this check box to enter or change a password that protects the job variable against unauthorized modification or deletion.
   	New password	Enter new write password in this field.
   	Confirmation	Confirm the new write password in this field.
   Current contents	Here you can edit the contents of the job variable.

4. Choose the OK button.

Displaying the Properties of a BS2000 Job Variable

You can display information about a BS2000 job variable.

To display the properties of a BS2000 job variable

1. In the object workspace, select the appropriate job variable in the Job Variables folder.

2. Invoke the context menu and choose Properties.

   Or:
   Press ALT+ENTER.

   A properties dialog box appears.

   

   The following information is shown in this dialog box:

   Option	Description
   Name	Name of the job variable.
   Security	Shared file	YES	The job variable is accessible to other users.
   		NO	The job variable is not accessible to other users.
   	Access type	READ	Only read access is allowed.
   		WRITE	Read and write access are allowed.
   	Read password	NONE	No password is defined.
   		YES	Read password is defined for job variable. If the caller is TSOS and Entire System Server is running under TSOS, the password itself is returned.
   	Write password	NONE	No password is defined.
   		YES	Write password is defined for job variable. If the caller is TSOS and Entire System Server is running under TSOS, the password itself is returned.
   Contents of n bytes	Displays the content and length of the job variable.
   Last modification	Date of last modification in format YYYY-MM-DD.
   Expiration date	The date (YYYY-MM-DD) after which the job variable can be erased.