Configuration of an Outpatient VistA
This is the Configuration and Setup a Outpatient VistA which is described as a VistA system setup to have no Inpatients but to provide services solely to patients that never get admitted, but may have some inpatient like services provided to them. It is based on the instuctions at Begin Configuration of Vista with an attempt to update it 2020. Internally, it is more modular with transclusion of well defined sub actions.
The BOLD entries represent user supplied input during the configuration process.
VistA's output is supplied in this guide so the user can follow along step by step as the configuration proceeds.
As a general rule user input is placed after the double slash at the VistA prompt.
Ex. Should I continue anyway? N//
no would be the default
If you would like to change the default value you must supply a Y or YES after the //.
Since this is a very long document I have created shorter documents that you can follow in order to a conclusion if you wish.
- Setting Mumps Routines
- Configuration of an Outpatient VistA/Configuring A Domain
- Configuration of an Outpatient VistA/Configuring An Institution and Facility
- Configuration of an Outpatient VistA/Configuring An Administrator User
- Configuration of an Outpatient VistA/Configuring Administration Menus and Devices
- Configuring Taskman, Mailman and RPC Broker
- Configuring CPRS Keys and Tabs
Contents
- 1 Let's begin configuration of VistA.
- 2 Create the DOMAIN.
- 3 Now to complete the DOMAIN setup by Christening the new domain.
- 4 Determine the internal entry of the new domain.
- 5 Adjust system files to new domain
- 6 Determine proper value for BOX-VOLUME PAIR
- 7 Update the RPC BROKER SITE PARAMETER File.
- 8 Setup a System Administrator Account
- 9 Determine System Administrator account number
- 10 Assign keys to System Administrator Account
- 11 Setup VistA Application Software Parameters
- 12 Add a Medical Center Division.
- 13 Enter additional information for the System Administrator user
- 14 Set Up Menus for the System Manager
- 15 Add the XMUSER Menu to Mailman Menu.
- 16 Change the default time before users are automatically signed off
- 17 Update the Devices, Start Taskman and Mail a Message
- 18 Check TaskMan's environement
- 19 Start TaskMan
- 20 Send a Message
- 21 Check Mail
- 22 Start and Test RPC Broker
- 23 Overview of starting and stopping components
Let's begin configuration of VistA.
Getting into programmers mode
Run ^ZTMGRSET
Initialize FileMan to set the site name and number
Determine the "BOX:VOLUME pair" for the machine.
M>D GETENV^%ZOSV W Y
The BOX:VOLUME pair for this machine is ROU:bonez
UCI^VOL^NODE^BOX:VOLUME
VAH^ROU^bonez^ROU:bonez
UCI = VAH
VOL = ROU
NODE = bonez
BOX = ROU
VOLUME = bonez
-------------------------
Create the DOMAIN.
From the M prompt, start VA FileMan by typing "D Q^DI". At the Select OPTION: prompt. Type "1". (You can see why you typed 1 if you type "??" at the option prompt.
NB: If you are prompted for an ACCESS CODE, press ENTER until you get back to the M prompt and enter "S DUZ=1" before running "D Q^DI".
That will give you the list of options you can choose from and 1 is ENTER OR EDIT FILE ENTRIES.) At INPUT TO WHAT FILE: type "DOMAIN" and accept the ALL// default to EDIT WHICH FIELD. At Select DOMAIN NAME: enter a local domain name. Substitute an appropriate value for VISTA.MYDOMAIN.COM in the example below.
M>D Q^DI
VA FileMan 22.0
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: DEVICE//DOMAIN (18 entries)
EDIT WHICH FIELD: ALL//
Select DOMAIN NAME:?
Answer with DOMAIN NAME, or TCP/IP POLL FLAG, or SYNONYM
Do you want the entire 18-Entry DOMAIN List?Y (Yes)
Choose from:
BONEZ.STREETCHIRO.COM
EPHARMACY.VITRIA-EDI.AAC.VA.GO
FHIE.MED.VA.GOV
FORUM.VA.GOV
GOV
MAIL.CIO.MED.VA.GOV
MPIDC-AUSTIN.MED.VA.GOV
Q-CLU.MED.VA.GOV
Q-CLW.MED.VA.GOV
Q-NPC.MED.VA.GOV
Q-NPP.MED.VA.GOV
Q-NPQ.MED.VA.GOV
Q-PSS.MED.VA.GOV
Q-SCD.MED.VA.GOV
TPB-AUSTIN.MED.VA.GOV
VISTA.MED.VA.GOV
VISTA.PLATINUM.MED.VA.GOV
VISTA.STREETCHIRO.COM
You may enter a new DOMAIN, if you wish
Answer must be 1-64 characters in length.
Select DOMAIN NAME:BONEZ.OSWIZARDS.COM
Are you adding 'BONEZ.OSWIZARDS.COM' as a new DOMAIN (the 19TH)? No//Y (Yes)
FLAGS:^
------------------------------
Now to complete the DOMAIN setup by Christening the new domain.
Go back to the M prompt and type "D CHRISTEN^XMUDCHR".
M>D CHRISTEN^XMUDCHR
* * * * WARNING * * * *
You are about to change the domain name of this facility
in the MailMan Site Parameters file.
Currently, this facility is named: BONEZ.STREETCHIRO.COM
You must be extremely sure before you proceed!
Are you sure you want to change the name of this facility? NO// YES
Select DOMAIN NAME: BONEZ.STREETCHIRO.COM//BONEZ
1 BONEZ.OSWIZARDS.COM
2 BONEZ.STREETCHIRO.COM
CHOOSE 1-2: 1 BONEZ.OSWIZARDS.COM
The domain name for this facility is now: BONEZ.OSWIZARDS.COM
PARENT: VISTA.STREETCHIRO.COM//
TIME ZONE: PDT//PST PACIFIC STANDARD
VISTA.STREETCHIRO.COM has been initialized as your 'parent' domain.
(Forum is usually the parent domain, unless this is a subordinate domain.)
You may edit the MailMan Site Parameter file to change your parent domain.
We will not initialize your transmission scripts.
Use the 'Subroutine editor' option under network management menu to add your site passwords to the MINIENGINE script, and the 'Edit a script' option to edit any domain scripts that you choose to.
M>
--------------------------
Determine the internal entry of the new domain.
Remember this number as it will be used in subsequent steps.
Get back to the Select OPTION: prompt and enter "INQUIRE" or "5" (once again, you can type ?? to see the available options and 5 is INQUIRE TO FILE ENTRIES) then at the Select DOMAIN NAME: prompt, enter the new domain name you just created. Answer "N" to STANDARD CAPTIONED OUTPUT and at PRINT FIELD: answer "NUMBER". The domain number is "printed" to the screen.
M>D Q^DI
VA FileMan 22.0
Select OPTION: 5 INQUIRE TO FILE ENTRIES
OUTPUT FROM WHAT FILE: DOMAIN//
Select DOMAIN NAME:BONEZ
1 BONEZ.OSWIZARDS.COM
2 BONEZ.STREETCHIRO.COM
CHOOSE 1-2:1 BONEZ.OSWIZARDS.COM
ANOTHER ONE:
STANDARD CAPTIONED OUTPUT? Yes// (Yes)
Include COMPUTED fields: (N/Y/R/B): NO// BOTH Computed Fields and Record Number (IEN)
NUMBER: 22 NAME: BONEZ.OSWIZARDS.COM
LEVEL 1 NAME (c): COM LEVEL 2 NAME (c): OSWIZARDS.COM
LEVEL 3 NAME (c): BONEZ.OSWIZARDS.COM
LEVEL 4 NAME (c): BONEZ.OSWIZARDS.COM
Select DOMAIN NAME:
See, my number for the domain is 22 in this instance.
-----------------------------
Adjust system files to new domain
From the M prompt repoint the KERNEL SYSTEM PARAMETERS and repoint the RPC BROKER PARAMETERS files to the new domain, go back to the M> prompt and enter 'S $P(^XTV(8989.3,1,0),"^")=3' and 'S $P(^XWB(8994.1,1,0),"^")=3' where 3 is the internal number of the new domain we just created in the previous step.
The domain instance of 22 is used below. I have NO idea what this command mean. I only know that it resets the kernel parameters and RPC broker parameters to my domain defined above.
M>S $P(^XTV(8989.3,1,0),"^")=22
M>S $P(^XWB(8994.1,1,0),"^")=22
M>
Then from the GTM> prompt again start FileMan with "D Q^DI". At Select OPTION: enter "6" (UTILITY FUNCTIONS) then select RE-INDEX FILE. At the MODIFY WHAT FILE, prompt enter "KERNEL SYSTEM PARAMETERS". Then do the same for the RPC BROKER PARAMETERS file. See example below for the rest of the dialogue.
M>D Q^DI
VA FileMan 22.0
Select OPTION: UTILITY FUNCTIONS
Select UTILITY OPTION: RE-INDEX FILE
MODIFY WHAT FILE: KERNEL SYSTEM PARAMETERS//
THERE ARE 13 INDICES WITHIN THIS FILE
DO YOU WISH TO RE-CROSS-REFERENCE ONE PARTICULAR INDEX? No// NO (No)
OK, ARE YOU SURE YOU WANT TO KILL OFF THE EXISTING 13 INDICES? No// YES (Yes)
DO YOU THEN WANT TO 'RE-CROSS-REFERENCE'? Yes// (Yes)
...SORRY, LET ME THINK ABOUT THAT A MOMENT...
FILE WILL NOW BE 'RE-CROSS-REFERENCED'................
Select UTILITY OPTION:
Select UTILITY OPTION: RE-INDEX FILE
MODIFY WHAT FILE: KERNEL SYSTEM PARAMETERS// RPC BROKER SITE PARAMETERS
(1 entry)
THERE ARE 5 INDICES WITHIN THIS FILE
DO YOU WISH TO RE-CROSS-REFERENCE ONE PARTICULAR INDEX? No// (No)
OK, ARE YOU SURE YOU WANT TO KILL OFF THE EXISTING 5 INDICES? No// YES (Yes)
DO YOU THEN WANT TO 'RE-CROSS-REFERENCE'? Yes// (Yes)
...SORRY, THIS MAY TAKE A FEW MOMENTS...
FILE WILL NOW BE 'RE-CROSS-REFERENCED'......
Select UTILITY OPTION:
Check the VOLUME SET File. The VOLUME SET File should not need any changes. At Select OPTION: enter "1" for EDIT OR ENTER FILE ENTRIES. The choice should be INPUT TO WHAT FILE: SOME OTHER CHOICE//VOLUME SET EDIT WHICH FIELD: ALL// At Select VOLUME SET prompt type "??" to see a list of entries. When asked which volume set again, type in whatever it is.
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: RPC BROKER SITE PARAMETERS// VOLUME SET
(1 entry) EDIT WHICH FIELD: ALL//
Select VOLUME SET: ??
ROU
You may enter a new VOLUME SET, if you wish
Answer should be the name of a volume set.
When each cpu can have only one volume set, this is also the cpu name.
Answer will be used in extended global references to reach this volume.
Select VOLUME SET: ROU
VOLUME SET: ROU//
TYPE: GENERAL PURPOSE VOLUME SET//
INHIBIT LOGONS?: NO//
LINK ACCESS?: YES//
OUT OF SERVICE?: NO//
REQUIRED VOLUME SET?: NO//
TASKMAN FILES UCI: ROU//
TASKMAN FILES VOLUME SET: ROU//
REPLACEMENT VOLUME SET:
DAYS TO KEEP OLD TASKS: 4//
SIGNON/PRODUCTION VOLUME SET: Yes//
Select VOLUME SET:
Determine proper value for BOX-VOLUME PAIR
This step is to get the proper value for the BOX-VOLUME PAIR in the TASKMAN SITE PARAMETERS File. Edit the TASKMAN SITE PARAMETER File (# 14.7) to update the BOX-VOLUME PAIR. Note that when you enter a "?" at the BOX-VOLUME PAIR prompt, it tells you what the correct value should be.
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: VOLUME SET// TASKMAN SITE PARAMETERS
(1 entry) EDIT WHICH FIELD: ALL//
Select TASKMAN SITE PARAMETERS BOX-VOLUME PAIR: ?
Answer with TASKMAN SITE PARAMETERS BOX-VOLUME PAIR:
ROU:bonez
You may enter a new TASKMAN SITE PARAMETERS, if you wish
Answer must be 3-30 characters in length.
The value for the current account is ROU:bonez
Select TASKMAN SITE PARAMETERS BOX-VOLUME PAIR: ROU:bonez
BOX-VOLUME PAIR: ROU:bonez//
RESERVED: ^
Update the RPC BROKER SITE PARAMETER File.
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: TASKMAN SITE PARAMETERS// RPC BROKER SITE PARAMETERS
(1 entry) EDIT WHICH FIELD: ALL//
Select RPC BROKER SITE PARAMETERS DOMAIN NAME: BONEZ.OSWIZARDS.COM
...OK? Yes// YES (Yes)
DOMAIN NAME: BONEZ.OSWIZARDS.COM//
MAIL GROUP FOR ALERTS:
Select BOX-VOLUME PAIR: ROU:bonez//
BOX-VOLUME PAIR: ROU:bonez//
Select PORT: 9200//
PORT: 9200//
TYPE OF LISTENER: Original//
STATUS: STOPPED//
CONTROLLED BY LISTENER STARTER: NO//
Select RPC BROKER SITE PARAMETERS DOMAIN NAME:
Setup a System Administrator Account
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: RPC BROKER SITE PARAMETERS// NEW PERSON
(11 entries) EDIT WHICH FIELD: ALL// .01 NAME
THEN EDIT FIELD: ACCESS CODE Want to edit ACCESS CODE (Y/N)
THEN EDIT FIELD:
Select NEW PERSON NAME: ADMINISTRATOR, SYSTEM
Are you adding 'ADMINISTRATOR,SYSTEM' as a new NEW PERSON (the 12TH)? No// YES (Yes)
Checking SOUNDEX for matches.
No matches found.
NEW PERSON INITIAL: SA
NEW PERSON MAIL CODE:
Want to edit ACCESS CODE (Y/N): Y
Enter a new ACCESS CODE <Hidden>: ********
Please re-type the new code to show that I have it right: ********
OK, Access code has been changed!
The VERIFY CODE has been deleted as a security measure.
The user will have to enter a new one the next time they sign-on.
Select NEW PERSON NAME:
Determine System Administrator account number
Inquire System Administrator account information and number
Select OPTION: 5 INQUIRE TO FILE ENTRIES
OUTPUT FROM WHAT FILE: NEW PERSON//
Select NEW PERSON NAME: ADMINISTRATOR,SYSTEM SA
ANOTHER ONE:
STANDARD CAPTIONED OUTPUT? Yes// Y (Yes)
Include COMPUTED fields: (N/Y/R/B): NO// BOTH Computed Fields and Record Number (IEN)
NUMBER: 10 NAME: ADMINISTRATOR,SYSTEM
INITIAL: SA ACCESS CODE: <Hidden>
DATE ENTERED: MAR 31, 2005 CREATOR: 0
Entry Last Edit Date: MAR 31, 2005 NAME COMPONENTS: 200
SIGNATURE BLOCK PRINTED NAME: SYSTEM ADMINISTRATOR
DATE ACCESS CODE LAST CHANGED (c): MAR 31,2005
PROVIDER KEY (c): 0
Select NEW PERSON NAME:
Assign keys to System Administrator Account
Now set the System Administrator and assign keys to the account.
Select OPTION:
M>SET DUZ=10
M>S $P(^VA(200,DUZ,0),"^",4)="@"
M>D ^XUP
Setting up programmer environment
This is a TEST account.
Select TERMINAL TYPE NAME: C-VT100
1 C-VT100 Digital Equipment Corporation VT-100 video
2 C-VT100HIGH Normal display of characters in BOLD !
CHOOSE 1-2: 1 C-VT100 Digital Equipment Corporation VT-100 video
Terminal Type set to: C-VT100
Select OPTION NAME: XUMAINT Menu Management
Select Menu Management Option: KEY Management
Select Key Management Option: ALLOCATION of Security Keys
Allocate key: XUMGR
Another key: XMMGR
Another key: XUPROGMODE
Another key: XUPROG
1 XUPROG
2 XUPROGMODE
CHOOSE 1-2: 1 XUPROG
Another key:
Holder of key: ADMINISTRATOR,SYSTEM SA
Another holder:
You've selected the following keys:
XUPROG XUMGR XUPROGMODE XMMGR
You've selected the following holders:
ADMINISTRATOR,SYSTEM
You are allocating keys. Do you wish to proceed? YES// YES
XUPROG being assigned to:
ADMINISTRATOR,SYSTEM
XUMGR being assigned to:
ADMINISTRATOR,SYSTEM
XUPROGMODE being assigned to:
ADMINISTRATOR,SYSTEM
XMMGR being assigned to:
ADMINISTRATOR,SYSTEM
Select Key Management Option:
Setup VistA Application Software Parameters
If you are planning to use the VistA applications such as Registration, Scheduling etc. you need to add new Institution to the INSTITUTION File.
Go back to the M> prompt and "SET XUMF=1" then "D Q^DI". Select Option #1 and edit File #4. Edit the field STATION NUMBER. For Station Number, you must enter the same number as the Site Number when you initialized FileMan. (See Start FileMan and Begin Setting Up Vista section.)
M>D Q^DI
VA FileMan 22.0
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: 4 INSTITUTION (67 entries)
EDIT WHICH FIELD: ALL// STATION NUMBER
THEN EDIT FIELD:
Select INSTITUTION NAME: OSWIZARDS MEDICAL CENTER
Are you adding 'OSWIZARDS MEDICAL CENTER' as
a new INSTITUTION (the 68TH)? No// YES (Yes)
STATION NUMBER: 1234
Select INSTITUTION NAME:
Add a Medical Center Division.
Select File #40.8 and edit fields FACILITY NUMBER and INSTITUTION FILE POINTER.
Enter the Institution STATION NUMBER for FACILITY NUMBER and the name of the Institution in INSTITUTION FILE POINTER.
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: INSTITUTION// 40.8 MEDICAL CENTER DIVISION
(2 entries)
EDIT WHICH FIELD: ALL// FACILITY NUMBER
THEN EDIT FIELD: INSTITUTION FILE POINTER
THEN EDIT FIELD:
Select MEDICAL CENTER DIVISION NAME: OSWIZARDS MEDICAL CENTER
Are you adding 'OSWIZARDS MEDICAL CENTER' as
a new MEDICAL CENTER DIVISION (the 3RD)? No// Y (Yes)
MEDICAL CENTER DIVISION NUM: 3//
MEDICAL CENTER DIVISION FACILITY NUMBER: 1234A
FACILITY NUMBER: 1234A//
INSTITUTION FILE POINTER: OSWIZARDS MEDICAL CENTER 1234
Select MEDICAL CENTER DIVISION NAME:
Enter additional information for the System Administrator user
PRIMARY MENU, VERIFY CODE etc.
From the M prompt, type "D ^XUP".
OPTION NAME: XUSEREDIT, it will give you two choices, select 1.
At Select NEW PERSON NAME: ADMINISTRATOR
1. EDIT AN EXISTING USER
Edit an Existing User
NAME: ADMINISTRATOR,SYSTEM Page 1 of 5
_______________________________________________________________________________
NAME... ADMINISTRATOR,SYSTEM INITIAL: SA
TITLE: NICK NAME: root
SSN: DOB:
DEGREE: MAIL CODE:
DISUSER: TERMINATION DATE:
Termination Reason:
PRIMARY MENU OPTION: EVE
Select SECONDARY MENU OPTIONS: OR CPRS GUI CHART
Want to edit ACCESS CODE (Y/N): FILE MANAGER ACCESS CODE: @
Want to edit VERIFY CODE (Y/N):
Select DIVISION:
SERVICE/SECTION: IRM
_______________________________________________________________________________
*** Press <RET> to edit the component parts of this name. ***
Press <PF1>H for help Insert
Multiple questions on the User Characteristic Fields Multiple signons, etc.
Set Up Menus for the System Manager
EVE is the System Manager menu
XUCOMMAND is a common menu available to all users.
Make FileMan, MailMan, and Manage MailMan menus accessible to the System Manager.
From the GTM prompt, type "D ^XUP".
At Select OPTION NAME: enter "XUMAINT".
Then at Select Menu Management, type "EDIT OPTIONS", then pick EVE.
Select 1 from the list then at NAME: EVE// type "^10".
At Select ITEM: enter "DIUSER".
Hit enter until you get to Select ITEM again (you may enter data for the other fields like SYNONYM if you wish).
At the next Select ITEM: enter "XMMGR".
GTM>D ^XUP
Setting up programmer environment
This is a TEST account.
Terminal Type set to: C-VT100
Select OPTION NAME: XUMAINT Menu Management
Select Menu Management Option: EVE ??
Select Menu Management Option: edit options
Select OPTION to edit: EVE
1 EVE Systems Manager Menu
2 EVENT CAPTURE (ECS) EXTRACT AU ECX ECS SOURCE AUDIT Event Capture
(ECS) Extract Audit
3 EVENT CAPTURE DATA ENTRY ECENTER Event Capture Data Entry
4 EVENT CAPTURE EXTRACT ECXEC Event Capture Extract
5 EVENT CAPTURE MANAGEMENT MENU ECMGR Event Capture Management Menu
Press <RETURN> to see more, '^' to exit this list, OR
CHOOSE 1-5: 1 EVE Systems Manager Menu
NAME: EVE// ^10 MENU
Select ITEM: XMMGR// DIUSER VA FileMan
...OK? Yes// (Yes)
ITEM: DIUSER//
SYNONYM:
DISPLAY ORDER:
Select ITEM: XMMGR Manage Mailman
...OK? Yes// YES (Yes)
ITEM: XMMGR//
SYNONYM:
DISPLAY ORDER:
Select ITEM:
CREATOR: SCHLEHUBER,CAMERON// ADMINISTRATOR,SYSTEM SA
HELP FRAME:
PRIORITY:
Select TIMES PROHIBITED:
Select TIME PERIOD:
RESTRICT DEVICES?:
Select PERMITTED DEVICE:
Select OPTION to edit:
Select Menu Management Option:
Add the XMUSER Menu to Mailman Menu.
GTM>D ^XUP
Setting up programmer environment
This is a TEST account.
Terminal Type set to: C-VT100
Select OPTION NAME: XUMAINT Menu Management
Select Menu Management Option: edit options
Select OPTION to edit: XUCOMMAND SYSTEM COMMAND OPTIONS
NAME: XUCOMMAND// ^10 MENU
Select ITEM: XMUSER// XMUSER MailMan Menu
...OK? Yes// YES (Yes)
MM
ITEM: XMUSER//
SYNONYM: MM// MM
DISPLAY ORDER:
Select ITEM:
CREATOR: STREET,MARK H// ^
Select OPTION to edit:
Change the default time before users are automatically signed off
To change the default time it takes before users are automatically signed off the system from the default of 300 seconds. This, again, is to give you more time to work as you are learning. Back out to the GTM prompt. At the GTM prompt, Type "D ^ZU".
At ACCESS CODE, type in the code you chose when setting up ADMINISTRATOR,SYSTEM.
At VERIFY CODE, hit ENTER. When asked for a new verify code enter and re-enter it.
GTM>D ^ZU
Volume set: ROU:bonez UCI: VAH Device: /dev/pts/1
ACCESS CODE: ********
VERIFY CODE:
Good afternoon root
You last signed on today at 14:24
You must change your VERIFY CODE at this time.
Enter a new VERIFY CODE: ********
Please re-type the new code to show that I have it right: ********
OK, Verify code has been changed!
WARNING -- TASK MANAGER DOESN'T SEEM TO BE RUNNING!!!!
Select Systems Manager Menu Option:
At Select Systems Manager Menu Option: Type "OPER"
(short for operations management) and hit enter.
You can see all of the choices available to you if you type "??".
At Select Operations Management Option: Type "KER"
(short for Kernel Management Menu) and hit enter.
At Select Kernel Management Menu Option: Type "ENT"
(short for Enter/Edit Kernel Site Parameters) and hit enter.
A similar screen as editing the SYSTEM MANAGER will be displayed.
Navigate the screen with the TAB key.
For DEFAULT TIMED-READ (SECONDS): change it to 3600
to allow an hour before being automatically signed off
Select Systems Manager Menu Option: OPERations Management
Select Operations Management Option: KERnel Management Menu
Select Kernel Management Menu Option: ENTer/Edit Kernel Site Parameters
Note: the TaskMan site parameters have been moved out of this file.
Use the Edit TaskMan Parameters option to edit those values.
Kernel Site Parameter edit
DOMAIN:BONEZ.OSWIZARDS.COM
DEFAULT # OF ATTEMPTS: 5 AGENCY CODE: VA
DEFAULT LOCK-OUT TIME: 600
DEFAULT MULTIPLE SIGN-ON: YES MULTIPLE SIGN-ON LIMIT:
DEFAULT AUTO-MENU: NO DEFAULT AUTO SIGN-ON: Disabled
DEFAULT LANGUAGE:
DEFAULT TYPE-AHEAD: YES
DEFAULT TIMED-READ (SECONDS): 3600 BROKER TIMEOUT: 180
BYPASS DEVICE LOCK-OUT: ASK DEVICE TYPE AT SIGN-ON:
LIFETIME OF VERIFY CODE: 90
DEFAULT INSTITUTION: SOFTWARE SERVICE
AUTO-GENERATE ACCESS CODES:
LOG RESOURCE USAGE?:
_______________________________________________________________________________
COMMAND: Press <PF1>H for help Insert
PAGE 2
Kernel Site Parameter edit
DOMAIN:BONEZ.OSWIZARDS.COM
Vol Set Max Sign-ons Log RT?
ROU 1000
VISTA 256 NO
ROUTINE MONITORING:
Routine Namespace's
PAGE 3
Kernel Site Parameter edit
DOMAIN:BONEZ.OSWIZARDS.COM
MAX SPOOL LINES PER USER: 9999999
MAX SPOOL DOCUMENTS PER USER:
MAX SPOOL DOCUMENT LIFE-SPAN:
LOG RESOURCE USAGE?:
DEFAULT DIRECTORY FOR HFS:
/tmp/
DNS IP: 192.168.1.3
NEW PERSON IDENTIFIERS:
PAGE 4
Kernel Site Parameter edit
DOMAIN:BONEZ.OSWIZARDS.COM
OPTION AUDIT: FAILED ACCESS ATTEMPTS:
INITIATE AUDIT: TERMINATE AUDIT:
Option to audit Namespace to audit
User to audit Device to audit
PAGE 5
Kernel Site Parameter edit
DOMAIN:BONEZ.OSWIZARDS.COM
IRM MAIL GROUP:
AFTER HOURS MAIL GROUP:
Update the Devices, Start Taskman and Mail a Message
These are basic devices to complete the setup. You can setup other devices, such as printers, later.
The system already comes with preconfigured devices.
It is best to leave the VOLUME SET(CPU) field blank. The help text for the field states: "If no name has been entered for this field, this device is assumed to be accessible from all CPUs in the network. In other words, when this device is referenced, the device handler will operate as if this device is resident on the local CPU".
The SIGN-ON/SYSTEM DEVICE: field should be set to NO or left blank for output devices and YES if the device is used to log on to the system.
Use FileMan to edit the CONSOLE, NULL, HFS, and TELNET devices.
- CONSOLE is the primary logon device.
- NULL device is used by the Vista RPC Broker
- HFS is used by the Kernel Installation and Distribution System (KIDS) to install application patches and new applications when they are released.
- TELNET device to allow remote access.
At the GTM> prompt, type "D Q^DI" to invoke VA Fileman.
At Select OPTION: type "1" (ENTER OR EDIT FILE ENTRIES)
at INPUT TO WHAT FILE:, enter "3.5"
GTM>D Q^DI
VA FileMan 22.0
Select OPTION: 1 ENTER OR EDIT FILE ENTRIES
INPUT TO WHAT FILE: NEW PERSON// 3.5 DEVICE (41 entries)
EDIT WHICH FIELD: ALL//
Select DEVICE NAME: CONSOLE
1 CONSOLE CONSOLE |TRM|
2 CONSOLE GTM-UNIX-CONSOLE Console (GT.M) /dev/tty ROU
CHOOSE 1-2: 2 GTM-UNIX-CONSOLE Console (GT.M) /dev/tty ROU
NAME: GTM-UNIX-CONSOLE//
LOCATION OF TERMINAL: Console (GT.M)//
Select MNEMONIC: CONSOLE//
LOCAL SYNONYM:
$I: /dev/tty//
VOLUME SET(CPU): ROU//
SIGN-ON/SYSTEM DEVICE: YES//
TYPE: VIRTUAL TERMINAL//
SUBTYPE: C-VT100//
ASK DEVICE: YES//
ASK PARAMETERS:
ASK HOST FILE:
ASK HFS I/O OPERATION: ^
Select DEVICE NAME: TELNET
1 TELNET TELNET |TNT|
2 TELNET GTM-UNIX-TELNET TELNET /dev/pts/ ROU
CHOOSE 1-2: 2 GTM-UNIX-TELNET TELNET /dev/pts/ ROU
NAME: GTM-UNIX-TELNET//
LOCATION OF TERMINAL: TELNET//
Select MNEMONIC: TELNET//
LOCAL SYNONYM:
$I: /dev/pts///
VOLUME SET(CPU): ROU//
SIGN-ON/SYSTEM DEVICE: YES//
TYPE: VIRTUAL TERMINAL//
SUBTYPE: C-VT320// C-VT100
1 C-VT100 Digital Equipment Corporation VT-100 video
2 C-VT100HIGH Normal display of characters in BOLD !
CHOOSE 1-2: 1 C-VT100 Digital Equipment Corporation VT-100 video
ASK DEVICE: YES//
ASK PARAMETERS: ^
Select DEVICE NAME: HFS Host File Server /tmp/tmp.txt ROU
NAME: HFS//
LOCATION OF TERMINAL: Host File Server//
Select MNEMONIC:
LOCAL SYNONYM:
$I: /tmp/tmp.txt// /tmp/vista-tmp.txt
VOLUME SET(CPU): ROU//
SIGN-ON/SYSTEM DEVICE: ^
Select DEVICE NAME: NULL
1 NULL NT SYSTEM //./nul
2 NULL GTM-UNIX-NULL Bit Bucket (GT.M-Unix) /dev/null
3 NULL-DSM Bit Bucket _NLA0:
CHOOSE 1-3: 2 GTM-UNIX-NULL Bit Bucket (GT.M-Unix) /dev/null
NAME: GTM-UNIX-NULL//
LOCATION OF TERMINAL: Bit Bucket (GT.M-Unix) Replace
Select MNEMONIC: NULL//
LOCAL SYNONYM:
$I: /dev/null//
VOLUME SET(CPU):
SIGN-ON/SYSTEM DEVICE: NO//
TYPE: TERMINAL// ^
Check TaskMan's environement
From the GTM prompt
Enter "D ^ZTMCHK" to check if TaskMan's environment is OK.
This will display two screens with information on TaskMan's environment.
GTM> D ^ZTMCHK
Checking Task Manager's Environment.
Checking Taskman's globals...
^%ZTSCH is defined!
^%ZTSK is defined!
^%ZTSK(-1) is defined!
^%ZIS(14.5,0) is defined!
^%ZIS(14.6,0) is defined!
^%ZIS(14.7,0) is defined!
Checking the ^%ZOSF nodes required by Taskman...
All ^%ZOSF nodes required by Taskman are defined!
Checking the links to the required volume sets...
There are no volume sets whose links are required!
Checks completed...Taskman's environment is okay!
Press RETURN to continue or '^' to exit:
Here is the information that Taskman has:
Operating System: GT.M (Unix)
Volume Set: ROU
Cpu-volume Pair: ROU:bonez
TaskMan Files UCI and Volume Set: ROU,ROU
Log Tasks?
Default Task Priority:
Submanager Retention Time: 0
Min Submanager Count:
Taskman Hang Between New Jobs: 0
TaskMan running as a type: GENERAL
Logons Inhibited?: N
Taskman Job Limit: 9999
Max sign-ons: 1000
Current number of active jobs:
End of listing. Press RETURN to continue:
Start TaskMan
If TaskMan's environment is OK, start TaskMan.
Go back to the GTM prompt and type "D ^ZTMB" to start TASKMAN.
You will probably not see any output from this command.
To monitor TaskMan, enter "D ^ZTMON" from the GTM prompt.
Enter "^" at the UPDATE// prompt to exit the monitor or enter a "?" to see what the other options are.
GTM> D ^ZTMON
Checking Taskman. Current $H=59991,54440 (Apr 01, 2005@15:07:20)
RUN NODE=59991,54432 (Apr 01, 2005@15:07:12)
Taskman is current..
Checking the Status List:
Node weight status time $J
ROU:bonez RUN T@15:07:12 5933 Main Loop
Checking the Schedule List:
Taskman has no tasks scheduled.
Checking the IO Lists:
There are no tasks waiting for devices.
Checking the Job List:
There are no tasks waiting for partitions.
For VISTA:NTA there are 0 tasks. Out Of Service
For VISTA:NTB there are 0 tasks. Out Of Service
Checking the Task List:
There are 2 tasks currently running.
On node ROU:bonez there is 1 free Sub-Manager(s). Status: Run
Enter monitor action: UPDATE//^
Send a Message
Now send a message using Postmaster to your DUZ number.
From the GTM prompt type "S DUZ=.5 then D ^XUP".
You will get the response SETTING UP PROGRAMMER ENVIROMENT
then TERMINAL TYPE SET TO: (your default) and Select OPTION NAME:
Respond: "XMUSER".
At Select Mailman Menu Option: type "S" (for send).
At Subject: enter your subject, such as Test, and then hit enter.
You will then be prompted You may enter the text of the message and you will be offered the line number 1> where you can type your message, such as the infamous Hello world. Next will be line 2> and if you are done, just hit enter and at EDIT Option: you can do the same.
At Send mail to: POSTMASTER// enter the initials you used for your DUZ which were probably SM for System Manager.
You will then be told when MailMan was last used, which is probably NEVER. Hit enter at And Send to: and you should receive the message Select Message option: Transmit now// at which you hit enter and will hopefully receive the message Sending [1] Sent. Type "^" to exit.
GTM>S DUZ=.5
GTM>D ^XUP
Setting up programmer environment
This is a TEST account.
Terminal Type set to: C-VT100
Select OPTION NAME: XMUSER MailMan Menu
VA MailMan 8.0 service for POSTMASTER@BONEZ.OSWIZARDS.COM
You last used MailMan: 01/18/05@15:11
You have no new messages.
Select MailMan Menu Option: S Send a Message
Subject: TESTING
You may enter the text of the message...
1>Hello, this is a test of the Emergency Broadcast System
2>
EDIT Option:
Send mail to: POSTMASTER// SA ADMINISTRATOR,SYSTEM IRM
Last used MailMan: 04/01/05@14:23
And Send to: MHS STREET,MARK H IRM Last used MailMan: Never
And Send to:
Select Message option: Transmit now// Sending [1]...
Sent
Select MailMan Menu Option:
Check Mail
Now see if you received your mail.
Log on using "D ^ZU".
At the Systems Manager prompt, type "MAIL".
Then at the Select MailMan Menu Option: type "NEW" Messages and Responses. Read the mail.
GTM>D ^ZU
Volume set: ROU:bonez UCI: VAH Device: /dev/pts/1
ACCESS CODE: ********
VERIFY CODE: ********
Good afternoon root
You last signed on today at 15:18
Select Systems Manager Menu Option: MAILMan Menu
VA MailMan 8.0 service for ADMINISTRATOR.SYSTEM@BONEZ.OSWIZARDS.COM
You last used MailMan: 04/01/05@15:19
You have 1 new messages.
Select MailMan Menu Option:
NEW
Subj: TESTING [#1] 04/01/05@15:13 1 line
From: POSTMASTER In 'IN' basket. Page 1
Hello, this is a test of the Emergency Broadcast System
Enter message action (in IN basket): Ignore//
Start and Test RPC Broker
Start and test the RPC Broker.
The RPC Broker is VistA's Client/Server software and is needed by VistA's GUI client.
Type "D STRT^XWBTCP(port)" at the GTM prompt.
The system status should now show the broker listener (XWBTCPL) running.
GTM>D STRT^XWBTCP(9200)
Start TCP Listener...
Checking if TCP Listener has started...
TCP Listener started successfully.
GTM>
CPRS Key and Tab Assignment
Enter D Q^DI at the GTM> prompt and choose 'Option 1' and the NEW PERSON file.
Fields to edit, first choose KEY, then CPRS TAB.
Assign the key ORES for unrestricted ordering as if you were a physician. (See page 21 in the CPRS Setup Guide for other keys.)
Under CPRS TAB, type ?? and you will see two choices, RPT and COR. Enter RPT first, then complete COR.
GTM>D Q^DI VA FileMan 22.0 Select OPTION: '''1''' ENTER OR EDIT FILE ENTRIES INPUT TO WHAT FILE: DEVICES// '''NEW PERSON''' EDIT WHICH FIELD: ALL// '''KEYS''' 1 KEYS (multiple) 2 KEYSTROKES FROM LM WP CHOOSE 1-2: '''1''' KEYS (multiple) EDIT WHICH KEYS SUB-FIELD: ALL// (Hit enter here) THEN EDIT FIELD: '''CPRS TAB''' (multiple) EDIT WHICH CPRS TAB SUB-FIELD: ALL// (Hit enter here) THEN EDIT FIELD: '''RESTRICT PATIENT SELECTION''' THEN EDIT FIELD: (Hit enter here) Select NEW PERSON NAME: ''SA'' ADMINISTRATOR,SYSTEM Select KEY: // '''ORES''' ...OK? Yes// (Yes) KEY: ORES// REVIEW DATE: Select KEY: (Hit enter here) Select CPRS TAB: // '''RPT''' EFFECTIVE DATE:// '''APRIL 1,2005''' EXPIRATION DATE:// '''APRIL 1,2020''' CPRS TAB: RPT// '''COR''' - the CPRS GUI "core" tabs. Are you adding 'RPT' as a new CPRS TAB (the 2ND for this NEW PERSON)? No// '''Y''' EFFECTIVE DATE:// '''APRIL 1,2005''' EXPIRATION DATE:// '''APRIL 1,2020''' Select CPRS TAB: (Hit enter here) RESTRICT PATIENT SELECTION:// '''NO''' Select NEW PERSON NAME:(Hit enter here) Select OPTION:(Hit enter here) GTM>
Overview of starting and stopping components
A quick overview of starting and stopping TaskMan, HL Filer Monitor and RPC Broker Listener components is in order.
1. To start TaskMan;
GTM>D ^ZTMB
2. To start Background Filers
GTM>D ^XUP
Setting up programmer environment
Access Code:
Terminal Type set to: C-VT100
Select OPTION NAME: START BACKGROUND FILER XMMGR-START-BACKGROUND-FILER START background filer
START background filer
<< Background Filers will start soon. >>
3. To start HL Filer Monitor
GTM>D ^XUP Setting up programmer environment Terminal Type set to: C-VT100 Select OPTION NAME: HL FILER MONITOR Task Number of Asked Incoming Filer To Stop Last Known Date/Time Time Difference ** No incoming filers are running ** Task Number of Asked Outgoing Filer To Stop Last Known Date/Time Time Difference ** No outgoing filers are running ** (+I) Start incoming filer (-I) Stop incoming filer (*I) Delete incoming filer (+O) Start outgoing filer (-O) Stop outgoing filer (*O) Delete outgoing filer (N) Next 4 lines in list (B) Back 4 lines in list (Q) Quit Type selection:Q
4. Start the RPC Broker Listener, pick a port you want to run the listener on. ex. 9210
GTM>D STRT^XWBTCP(9210)
5. To Stop RPC Broker Listener.
GTM>D STOP^XWBTCP(9210)
6. To stop Mailman Background Filers
GTM>D ^XUP
Setting up programmer environment Access Code:
Terminal Type set to: C-VT100
Select OPTION NAME: STOP BACKGROUND FILER
7. To stop HL FILER MONITOR run the exact same command as above and pick the proper selection from the menu at the bottom of the monitor.
GTM>D ^XUP Setting up programmer environment Terminal Type set to: C-VT100 Select OPTION NAME: HL FILER MONITOR Task Number of Asked Incoming Filer To Stop Last Known Date/Time Time Difference ** No incoming filers are running ** Task Number of Asked Outgoing Filer To Stop Last Known Date/Time Time Difference ** No outgoing filers are running ** (+I) Start incoming filer (-I) Stop incoming filer (*I) Delete incoming filer (+O) Start outgoing filer (-O) Stop outgoing filer (*O) Delete outgoing filer (N) Next 4 lines in list (B) Back 4 lines in list (Q) Quit Type selection:-I
8. To stop TaskMan
GTM>D STOP^ZTMKU
Are you sure you want to stop TaskMan? NO//Y
Shutting down TaskMan
Should active submanagers shut down after finishing their current tasks? NO//Y
Okay!
9. Rundown the database, from the vista user's shell prompt you can choose the alias or you can run the mupip command
vista$ rundown
or
mupip rundown -r "*"
