FORM.QUEUES File Maintenance
FORM.QUEUES File Maintenance enables you to create, change, and delete formqueue definition items in the FORM.QUEUES file in SYSFILES. You can also invoke this function by entering the FQM command at the TCL prompt.
FORM.QUEUES File Maintenance Menu (FQM)
When you select option 1 from the SPM menu or enter FQM, the system displays the FORM.QUEUES File Maintenance menu shown below:
F O R M . Q U E U E S F I L E M A I N T E N A N C E --------------------------------------------------------------- Queue name > 1 Queue Type : Status : 2 Page Skip : 3 Banner : 4 Tape Block Size : 5 Density : 6 Label : 7 Page Width : 8 Length : 9 Skip : 10 Default Job File 11 Description : 12 Prologue : 13 Epilogue : 14 Control Program : 15 Private Queue Ref : - Account : - File : 16 Assigned Despoolers :
Queue Name Prompt
At the queue name prompt:
Queue name >
you enter the name of the formqueue. The system displays the queue's current settings. For example, entering MYQUEUE may display a screen similar to that shown overpage.
If the queue is new, the system displays the settings from the DEFAULT item with the formqueue maintenance prompt.
To see a sorted list of all current formqueue definition items, enter a question mark (?).
To exit from this menu when the cursor is at the queue name prompt, press RETURN only.
F O R M . Q U E U E S F I L E M A I N T E N A N C E
---------------------------------------------------------------
Queue name >MYQUEUE
1 Queue Type :PUBLIC Status : No Despooler
2 Page Skip :1 3 Banner : YES
4 Tape Block Size :none 5 Density : none 6 Label:none
7 Page Width :none 8 Length : none 9 Skip :none
10 Default Job File :none
11 Description :DEFAULT
12 Prologue :none 13 Epilogue : none
14 Control Program :none
15 Private Queue Ref :none
- Account :none
- File :none
16 Assigned Despoolers :none
Enter option# (1-16) to change; EX to exit; FI to file; FD to delete :
Timeout
Once you have entered a formqueue name, the system sets locks to prevent other users from changing data. If you do not enter any data for two minutes, the system cancels out any changes that have not been filed and unlocks the data.
Formqueue Maintenance Prompt
Once you enter a queue name, the formqueue maintenance prompt is displayed at the bottom of the screen
EX to Exit Without Filing the Item
To exit when the cursor is at the formqueue maintenance prompt, enter:
EX
The system leaves the item as it was the last time it was filed. If the item was never filed, it remains unfiled.
The system clears the options displayed with the formqueue maintenance menu and prompts for a queue name.
FI to File the Item
To file the item as it is currently displayed, enter:
FI
The system writes the item to the FORM.QUEUES file, clears the options displayed, and prompts for a queue name.
FD to Delete the Item
To delete the item currently displayed, enter:
FD
The system prompts:
Delete - Are you sure ? (Y/N) :
Enter Y to
delete the item, or N to
cancel the delete.
If you enter Y, the
system deletes the item, clears the options displayed with the formqueue
maintenance menu, and prompts for a queue name.
To Change an Option
To change an option in the queue definition, enter the option's number at the formqueue maintenance prompt. The system displays a prompt for that option as described below. The system also displays the following message:
Enter new value, <return> to leave unchanged or ? for help.
Option 1 - Queue Type
This option allows you to specify whether the queue is public or private.
To change the queue type enter 1. The system prompts:
Formqueue type (1 = PUBLIC, 2 = PRIVATE) :
Enter:
1 to make
the queue public.
2 to
make the queue private.
Press RETURN to leave the option unchanged.
Option 2 - Page Skip
This option specifies the number of printer pages to be skipped at the end of each job.
To change the page skip number enter 2. The system prompts:
Number of inter-job page throws :
Enter the number (0-10) of pages that should be skipped when a job ends. Press RETURN to leave the option unchanged.
Option 3 - Print Banner
This option specifies whether or not a banner is to be printed when a job from this queue is output.
To change the print banner setting enter 3. The system prompts:
Print Banner page before each job? :
Enter:
Y to print a banner.
N to not print a banner.
Press RETURN to leave the option unchanged.
Option 4 - Tape Block Size
This option specifies a block size if the print data is output to tape.
To change the tape block size enter 4. The system prompts:
Tape Block size if Formqueue is assigned to a tape device :
Enter a number in the range 20 to 31764, inclusive. If the number is not a multiple of 512, the system pads records up to the next higher multiple of 512.
Note
Tape despooler records larger then 32Kbytes are not supported.
Enter a backslash
(\) to
specify "none". Press RETURN to leave
the option unchanged.
Option 5 - Tape Density
This option specifies a density if the print data is output to tape.
To change the tape density enter 5. The system prompts:
Tape Density if Formqueue is assigned to a tape device :
Enter a number in the range 1 to 9999. The system will use the largest tape density number (800, 1600, and so forth), equal to or less than the number you enter.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 6 - Tape Label Type
This option specifies the type of label a print data tape should have.
To change the tape label type enter 6. The system prompts:
Tape Label type (0,1 or 2) :
Enter:
0 for no label.
1 for a 50-byte label.
2 for an SMA label.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 7 - Printer Page Width
This option specifies the width of the page being used with this formqueue. This option has the same effect as parameter g of the TERM command
To change the printer page width specification enter 7. The system prompts:
Page Width if Formqueue is assigned to a printer device:
Enter the number (10-1000) that specifies the width of the paper to be used with this queue.
Enter a backslash (\)
to specify "none". Press RETURN
to leave the option unchanged.
Option 8 - Printer Page Length
This option specifies the length of the page being used with this formqueue. This has the same effect as parameter h of the TERM command.
To change the printer page length specification enter 8. The system prompts:
Page Depth if Formqueue is assigned to a printer device:
Enter the number (4-32767) that specifies the length of the paper to be used with this queue.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 9 - Number of Lines to Skip at Top of Page
This option specifies the number of blank lines at the top of a page for print jobs in this formqueue. This has the same effect as parameter j of the TERM command.
To change the number of lines to skip at the top of page enter
9. The system prompts:
Number of lines to skip at top of page when using DataBasic HEADING:
Enter the number of lines required (0-10).
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 10 - Default Job File
This option specifies the default job file for this formqueue. If a job file is not specified in the SP-ASSIGN command, the system uses the file specified in here.
To change the default job file enter 10. The system prompts:
Default job file for THIS queue. (Overrides system-wide default
Entire current value is : -
job-file-name
Enter new value on the line below :
Enter the job file name.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 11 - Formqueue Description
This option is a free-form description of the queue.
To change the queue description enter 11. The system prompts:
Description
Entire current value is : -
description
Enter new value on the line below :-
Enter a brief description of the queue.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 12 - Prologue Item-id
This option specifies the
To change the prologue 12. The system prompts:
Printer Command String item id processed before outputting a job
Entire current value is : -
prologue-item-id
Enter new value on the line below :-
Enter the item-id of a prologue in the PCS.OUTPUT file.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 13 - Epilogue Item-id
This option specifies the item-id of an epilogue in the PCS.OUTPUT file. The Despooler will output the epilogue after despooling the print job.
To change the epilogue item-id enter 13. The system prompts:
Printer Command String item id processed after outputting a job
Entire current value is : -
epilogue-item-id
Enter new value on the line below :-
Enter the item-id of an epilogue in the PCS.OUTPUT file.
Enter a backslash (\)
to specify "none". Press RETURN to leave the option unchanged.
Option 14 - Control Program
This option specifies the name of a cataloged DataBasic program. The system will run this program prior to changing the device assignment when you enter the SP-DEVICE command or perform Action Code 4 of the Form Queue Status menu to allow interaction between the system and the operator.
To change the control program name enter 14. The system prompts:
Catalogued DataBasic program invoked by SP-DEVICE command
Entire current value is : -
program-name
Enter new value on the line below :-
Enter the name of a cataloged DataBasic program or a Proc.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 15 - Private Queue Reference
This option specifies a file to hold the definition item for a private queue. The file must be defined by a Q-pointer or a D-pointer in the current account.
Before you can enter a file name, you must specify in option 1 that the queue is private.
To change the private queue reference enter 15. The system prompts:
Name by which a Private Formqueue file will be referenced
Entire current value is : -
file-name
Enter new value on the line below :-
Enter a the name of a file. The system displays the file name you entered (which can be either a Q-point or a D-pointer name), its account, and its D-pointer name.
Enter a backslash (\)
to specify "none". Press RETURN to leave
the option unchanged.
Option 16 - Assigned Despoolers
This option specifies the Despoolers that can output jobs from this formqueue and their priorities. The Despoolers must be defined by items in the DESPOOLER.CONTROL file.
The priorities are 1 (highest) to 9 (lowest).
To change the list of Despoolers and their priorities enter
16. The system prompts:
Currently assigned Despoolers Priority # despooler name # # despooler-name # A(dd),C(hange),D(elete),* to finish :
Enter:
A to add a Despooler to the list.
C to change a Despooler's priority.
D to delete a Despooler from the list.
* to exit from the prompt.
Option 16 - Adding a Despooler
To add a Despooler to the list enter A. The system prompts:
Enter new despooler name and priority
Enter the Despooler name.
The system shifts the cursor below the Priority column on the display.
Enter the priority (1-9), 1 is high.
The system assigns the Despooler a sequence number and displays the number, the Despooler's name, and its priority.
Option 16 - Changing a Despooler's Priority
To change a
Despooler's priority enter C. The system prompts:
Enter number of despooler to change :
Enter the Despooler's sequence number.
The system displays the Despooler's name below the prompt and positions the cursor in the Priority column on the display.
Enter the priority (1-9).
The system re-displays the list of Despoolers with their priorities.
Option 16 - Deleting a Despooler
To delete a Despooler from the list enter D. The system prompts:
Enter number of despooler to delete :
Enter the Despooler's sequence number.
The system displays the Despooler's name below the prompt and prompts:
Delete - Are your sure ? (Y/N) :
To delete the Despooler enter Y. The system will reassign sequence numbers, if necessary,
and again list the currently assigned Despooler.
To cancel the delete enter N.
Option 16 - Exiting
To exit from option 16 enter *. The system returns to the formqueue maintenance prompt.