|
PHOENIX and PREFERENCE Supervisor
HOW TO CHECK VERSION
OF SYSTEM
From Supervisor Menu, use the 'System Info' option (F11). For
prior releases type 'trlse' at the command line for RELEASE information,
authorizations, and expiration dates.
HOW TO IDENTIFY WHAT
EXTENSION PRODUCTS ARE ON THE SYSTEM
From Supervisor Menu, use the 'System Info' option (F11). For
prior releases type 'erlse' at the command line for available
Extension products.
HOW
TO CREATE A SIGN-ON MESSAGE
To create sign-on messages access the Supervisor Mail Facility
by typing 'notes' from the command line and do the following:
- Select option 4 (write sign-on message)
- Place the cursor on the 'New Message' line
which is located under the 'From Term ID' and 'Date Posted'
columns.
- Select the edit message option (F1). Item
Selection menu displayed,
- Select text option (F10) to access text
editor.
- Create message.
- Select end option (F3) to return to the
Sign-on Message Facility screen.
- Message will not be displayed as an existing
message under the 'New Message' line.
There is a maximum of 10 messages that can
be defined. If all ten slots are filled, you must delete an existing
message to free up space.
UNABLE
TO EDIT THE LOGO FROM SIGN-ON FRAME EDITOR
This occurs when the edit/color graphics option on the system
profile setting is no. To correct, do the following:
- From the sign-on frame editor F1 to edit
the logo.
- Using F4 key, go to option mode.
- Type 'pro' at the keyword prompt.
- Change edit/color graphics option, on page
1 of profile setting, from 'N' to 'Y'.
HOW TO SET UP A COURSE
OR VOLUME FOR FKEY ACCESS FROM THE SIGN-ON FRAME
From Supervisor Menu, use the 'Signon' option (F10), or type 'signon'
at the command line, then choose F2, Edit PF keys option to set
up fkey access to a course or volume:
PF KEY DEFINITIONS
==============================================
F COURSE LABEL F COURSE LABEL
-- ------ ------ -- ------ ------
1 $gsgl1 self 13 ------ ------
2 cmitst cmitst 14 ------ ------
3 ------ ------ 15 ------ ------
4 ------ ------ 16 ------ ------
In the example above, F1 is set up for the
self registration extension and F2 is set up for the cmitst course.
HOW TO CHECK TERMINAL
ID SETTINGS
From Supervisor Menu, select the 'Terminal' option (F12) or for
prior releases type 'tid' at the command line. The Terminal ID
Administration screen will be displayed. To display the current
settings, set action field to 'S' and type the ID of the terminal
that you want to check the settings for, then 'enter'.
From the Terminal ID Administration screen
you can also add, modify, and delete terminals by using the associated
'Action'.
HOW TO ACCESS THE
SUPERVISOR MENU
The Supervisor Menu is a new feature that was added to the 7.7.0
release. To access, type 'menu' at the command line.
You can change the supervisor default
entry point to go directly to the Supervisor Menu by doing the
following:
- From Supervisor Menu
select 'Controls' (F2) option. The menu below will be displayed.
+--------SUPERVISOR CONTROLS---------+
| |
| Supervisor sign-on to menus .... N |
| |
| LANGUAGE |
| English ........................ Y |
| French ......................... _ |
| Italian ........................ _ |
| |
| EXIT OPTIONS |
| Exit to command line ........... _ |
| Exit to signon frame ........... _ |
| Exit from system ............... _ |
| Use Terminal ID setting ........ _ |
| Display EXIT options ........... Y |
| |
| |
| F3 Quit |
+------------------------------------+
- Change the 'Supervisor sign-on to menus'
field to 'Y'.
The 'Controls' option also allows you to change
the default language and the existing system default options.
HOW TO REASSEMBLE
A COURSE OR VOLUME
The reassemble command improves the efficiency of how course material
is stored, permits you to add space for program material, labels,
and comments areas, and enables you to change the number of users
that may be registered to the course and make a copy of the course.
The format of the reassemble command is as
follows:
re course_name/file/start_block/program_material/label_table/comments/users/suffix
The program, label, and comment parameters for the command indicate
the total number of blocks reserved, not additional blocks to
be added. If you wish to increase the size of these, you must
calculate the amount necessary and increase the block amount appropriately.
Examples:
1. If the program length for a file named 'COURSE' residing on
FILE 108 was 200 blocks in size and you now need 150 more blocks,
the reassemble command would look as follows:
re course/108//350
2. To copy a course, say 'CRSE1' to 'CRSE2',
once again residing in FILE108, you would enter the following
command:
re crse1/108//////crse2
'Unable to Register *reas1'
PHOENIX/PREFERENCE tried unsuccessfully to register the temporary
course name. This message indicates that course by the name *reas1
already exists on the system. Most likely during a previous reassemble
'ok' was not replied when prompted for permission to remove the
old copy of the course/volume. To resolve this problem, type 'remove
program *reas'1 at the command line.
'Insufficient Space'
There is not enough contiguous "blank" space available on the
program file to contain the course.
'Program Area Full'
The course/volume has reached the maximum size allowable, 32767.
'Program Is In Use'
Another author, supervisor, or student/reader is using the course.
Use the line status 'ls' command to determine who is using the
course.
'Program Not Found'
The specified course/volume could not be found. Verify course/volume
name entered correctly.
HOW TO IDENTIFY WHAT PROGRAM FILES ARE AVAILABLE
From Supervisor Menu, select the 'List File' option and type 'pf'
in the variable space. For prior releases type 'lf pf' at the
command line.
HOW TO LOCATE 'BLANK' SPACE ON PROGRAM FILES
From Supervisor Menu, select the 'List File' option and type the
number of the program file in the variable space, then <enter>.
Select 'Blanks' option (F4) from the program file display. For
prior releases, type 'lf file/b' at the command line.
HOW TO OBTAIN A LIST OF USERS WHO ARE ONLINE
Type the line status command 'ls' at the command line. You can
list information about a specific course by typing 'ls/course
name'.
HOW TO DISCONNECT A USER FROM THE SYSTEM
Use the 'ls' (line status) command to identify a user's line number.
Then type 'line off/line number. In the example below, the supervisor
is entering the command to line off user at line number 3 (s3
on test)
-> line off/3
-------- SUPERV ----- 01/24/03 ---- 01:11 PM ----- TYPE COMMAND ---------
LINE --TERM-- --UNIT--- TP PROGRM ---USER--- SESS RTIM DISK MSG
2 X081 VTAM 24 caitst s1 34 1 129 N
3 X078 VTAM 24 test s3 30 24 73 N
1 X080 VTAM 24 SUPERVISOR 1 0 9 N
HOW TO PUT A COURSE/VOLUME
ON HOLD
From Supervisor Menu, use option 'Program Option', type in the
course/volume. Put an 'x' by the 'hold' option and type the letter
of the user(s) that you wish to prevent access to. For prior releases,
type 'ho course/user category (s,a,x) or 'ho volume/user category
(s,a,x) at the command line.
Note: You cannot issue 'hold' command on a
course/volume that is currently being processed by the reassemble,
move course, or remove course commands.
HOW TO PUT SYSTEM
ON HOLD
From Supervisor Menu, select the free/hold option. Type an 'x'
next to the user category for which you wish to change system
status, then ENTER. For prior releases, type 'ho course/user category
(s, a, x)' at the command line.
HOW TO FREE USER(S)
TO PERMIT ACCESS TO A COURSE/VOLUME WHEN A HOLD IS IN EFFECT
From Supervisor Menu, use option 'Program Option', type in the
course/volume name. If a hold is currently active, the 'Held For'
field will identify the letter of the user(s) that the hold is
applicable to. Put an 'x' by the 'Free' option and type the letter
of the user(s) that you wish to permit access to. For prior releases,
type 'fr course/user category (s,a,x) or 'fr volume/user category
(s,a,x) at the command line.
Note: You cannot 'free' users from a course/volume
that is currently being processed by the reassemble, move course,
or remove course commands.
HOW TO SNOOP A USER
Supervisors can see a display of a screen image being viewed by
another user by typing 'snoop' and the line number of the terminal
that is to be viewed.
This feature is useful when users have questions
about a screen that they are viewing, when problems occur, or
when users simply don't know how to move on.
To identify a user's line number, use the 'ls'
(line status) command or access the supervisor Lines (F7) menu.
In the example below, the supervisor is entering the command to
snoop line number 2 (s1 on caitst).
-> snoop 2
-------- SUPERV ----- 01/24/03 ---- 01:11 PM ----- TYPE COMMAND ---------
LINE --TERM-- --UNIT--- TP PROGRM ---USER--- SESS RTIM DISK MSG
2 X081 VTAM 24 caitst s1 34 1 129 N
1 X080 VTAM 24 SUPERVISOR 1 0 9 N
HOW TO ADD SPACE
There are several types of "Add Space" messages that a user may
receive. Therefore, the supervisors may need to add space in different
contexts. Here is a list with the required or suggested actions
for the various out-of-space conditions:
ADD PROGRAM SPACE TO COURSE/VOLUME ... REassemble
ADD LABEL SPACE TO COURSE/VOLUME ... REassemble
ADD ROSTER SPACE TO CLASS ............ Instructor
Menu, then F6 Administer Students, then F5, 'Add Space'.
ADD USER SPACE TO COURSE/VOLUME ... SET
STudent or SET Reader in program.
ADD AUX SPACE TO COURSE ......... SET AUX
MAKE MORE CONTIGUOUS SPACE ON FILE: ..........
Run GSPFCOMP Utility
ADD USER SPACE TO SYSTEM ..........Run GSPUSER
Utility
ADD SPACE TO WORK00 ............... Supervisor
Menu Option 'Add to Work00' (7.7.0). For prior releases, refer
to Chapter 7 in Author User Guide.
HOW TO CREATE A GROUP
VOLUME
Follow these steps to create a PREFERENCE
group volume:
- Access the supervisor 'Group' option from
the Supervisor Menu (7.7.0) or type 'group' at the command line.
- Enter 'new' to make a new group of related
volumes, choose a 3 character group volume name, and list the
volumes that you wish to be its members.
- In each member volume access volume controls
and define 'Related volume group' as the group volume listed
in step 2. Readers signing on to member volumes can now access
a group listing and access all volumes in the group.
Create a 'master index' or allow readers
to sign-on directly to the group:
- Use the 'register program' option and the
'Author/writer menu' option ('cbr' from the command line) to
define a program as a group volume.
- From the group volume writer menu, add index
terms from member volumes to create 'master index' or register
readers to the group volume.
HOW TO CREATE A GROUP
WITHIN A GROUP
A group volume can include another group volume as a member when
using the GROUP command.
You may also add the index of the member group to the index of the
high-level group.
PREFERENCE supports the group-within-a-group structure to just one
level. In other words, a 'group-within-a-group-within-a-group' is
not supported.
HOW TO REGISTER A COURSE OR VOLUME
This process has two parts. First, from the Supervisor Menu, select
the 'Register Program' option, then type the name of the course
or volume in the name section. For prior releases type 'rc course/file'
or 'rv volume/file' at the command line.
Second, from the Supervisor Menu, select the 'Author/Writer Menu'
option, then type the name of the course or volume in the name section,
<enter>. For prior releases, type 'ease' (for course) or 'cbr'
(volume) at the command line. ('ease' or 'cbr' option from the command
line). The first time this option is used for the course or volume
you will be prompted to define the course or volume as a PHOENIX
CAI or CMI course or as a PREFERENCE CBR volume or group volume.
After establishing the program type, users will be taken to the
PHOENIX Author or PREFERENCE Writer Menu.
HOW TO MAKE A COPY OF A COURSE OR VOLUME
From Supervisor Menu, select the 'Reassemble' option, then type
the name of the course or volume in the name section. Use the 'rename'
field to type the new name, then 'enter'. For prior releases use
the reassemble command and specify the new name of the course or
volume in the suffix parameter.
Note: After you successfully copy a volume, you must access the
'new name' volume's Writer Menu and issue the forcetoc command to
adjust index terms to the new volume's name.
HOW TO ACCESS THE AUTHOR/WRITER MENU
From Supervisor Menu use 'Author/Writer Menu' option or at the command
line, type 'a course' (where 'course' is the name of a PHOENIX course)
or type 'w volume' (where 'volume' is the name of the PREFERENCE
volume), then 'enter'. Then type 'ease' for course or 'cbr' for
volume. If the course has already been defined as a CMI or CAI course,
the Author menu is displayed, if not, then you will be prompted
to define. Likewise, if the volume has already been defined as a
standalone volume or group volume, the Writer Menu is displayed,
if not, then you will be prompted to define.
You may also sign-on directly to the author menu from the sign-on
frame with a registered author or writer ID.
HOW TO REGISTER AN AUTHOR
From the Author Main Menu select 'Administer Users' option (F9).
You will be prompted to identify the class number. It is recommended
to register authors to class 00. Select F4 to register Author. Complete
the registration panel.
HOW TO REGISTER A WRITER
From the Writer Main Menu select 'Administer Users' option (F8),
then Select F4 to register Writer. Complete the registration panel.
USER DIRECTORY FULL
This message occurs when the GSPDIREC file needs to be enlarged.
Use GSPBDIR to allocate a larger GSPBDIR file.
INSUFFICIENT SPACE: ASK SUPERVISOR TO ADD xxx
RECORDS TO WORK00 IN GSWORK
This message occurs when trying to optimize course/volume and the
Work00 workfile is not large enough. Use Supervisor Menu Option
'Add to Work00' (7.7.0) . For prior releases refer to 'Enlarging
the Work00 Workfile' section in chapter 7 of the Author User Guide.
HOW TO RESOLVE "OUT OF SPACE" ISSUES
- INSUFFICIENT SPACE TO REGISTER YOU. CONTACT
YOUR INSTRUCTOR TO ADD SPACE:
There is not enough space in the class roster
files. From the Instructor Menu select 'Administer Students' (F6)
option and the 'Add Space' (F5) option. Enter the number of additional
students for whom you need to add space.
- NO USER RECORDS ARE AVAILABLE. PLEASE ADVISE
YOUR PHOENIX SUPERVISOR:
Maximum users allocated for the course has
been reached. Determine the current allocation by selecting 'Administer
Course' (F7) option from the Author Main Menu.
From Supervisor Menu, use option 'Program Options'; type in the
course in the name. Put an 'x' by 'set student' option and type
in the desired value. For prior releases, while in author mode,
type 'set st/value' at the command line to increase the user allocation.
NO STUDENT (USER) RECORDS AVAILABLE ON PHOENIX:
The amount of user space for the system has been used up. The GSPMUSER
utility should be run by the systems programmer to add user space.
NO AUXILIARY STORAGE AVAILABLE ON PHOENIX:
The GSPMUSER utility should be run to either add auxiliary storage
space or re-claim deleted auxiliary blocks.
...HAVE SUPERVISOR REASSEMBLE ADDING LABEL SPACE:
The course or volume needs to be reassembled, adding more label
space.
INSUFFICIENT PROGRAM SPACE:
The course or volume needs to be reassembled, adding more program
space.
WHAT TO CONSIDER WHEN USING PREFERENCE PSF
PRINT
To use the PSF print facility the "CBEUXOSR" User Exit must be installed.
PATHLORE provides both the source (in the distribution SAMPLIB)
and an executable (in the distribution LINKLIB) for CBEUXOSR. To
begin using this User Exit, the following must be done:
- If you are not currently using any User Exits,
then a GSPLIB DD statement must be added to the PHOENIX startup
JCL. The CBEUXOSR executable will be loaded from the DSN= specified
by the GSPLIB DD. This DSN= must be APF authorized.
- The following PHOENIX startup parameters
must be added:
MAXINDP=5, Maximum number of
concurrent print sessions MAXEXIT=1, If
you already have exits, bump your count by 1 EXIT=CBEUXOSR/CBEUXOSR,
 |
