MKAPR(1) Domain/OS BSD MKAPR(1)
NAME
mkapr - make an Apollo product report
SYNOPSIS
mkapr [-v]
DESCRIPTION
The mkapr command creates a product report. This command replaces the
crucr (create a user change request form) utility available in prior
software releases.
Output from mkapr may be in either (or both) of two forms:
1. Printed, human-readable copy; or
2. Encoded, transmittable form.
Printed product reports should be sent to:
APR Administrator/Customer Services
M/S CHG 01 CS
Apollo Computer Inc.
330 Billerica Road
Chelmsford, MA 01824
Encoded product reports may be sent to Apollo Customer Services via the
UUCP network. The network address is: apollo!apr_cs_admin
Recommended paths to Apollo are via attunix, mit-eddie, or decwrd!decvax
(these paths may change). Customer Services will acknowledge all product
reports received. Do not assume your product report has been received
until you receive a reply. Security-conscious sites should not send
confidential material. Voluminous submissions should be sent via
magnetic media.
OPTIONS
mkapr supports only one option, -v. This will assert verbose mode; any
system services called by by mkapr will be allowed to send output to the
standard output and/or standard error devices. Normal mode operation is
for mkapr to invoke the system services silently.
SERVICES SUPPORTED
In addition to creating Apollo Problem Reports online, mkapr will make
available viewing, editing, printing and mailing services if they exist
(and mkapr can find them). The mailing service known to mkapr is:
Unix environment - sendmail
The print services known to mkapr are:
Aegis environment - prf
BSD environment - lpr
SysV environment - lp
If a desired service is not available to mkapr, a product report (print
or send) file will be saved in the current directory for printing or
sending at a later time.
DIALOG INTERFACE
mkapr will make use of the DIALOG graphic interface environment of the
Apollo Domain system whenever possible. This interface is designed for
ease of learning and use.
COMMAND DRIVEN INTERFACE
If the display environment you are using does not support the graphic
interface, you will see the following prompt:
mkapr>
Entering the command 'help' will display the available commands. Here is
the list of commands for reference:
Command Description
help [mkapr] List Commands. To display the help file, use the mkapr
option.
change Change APR Information Fields.
edit Edit the detailed Problem Description.
view View the current APR.
print Print the current APR.
send Send the current APR.
exit Save current customer information changes (if any) and
exit.
cancel Exit without saving customer information changes.
You need only enter as much of any command as is necessary to uniquely
identify it. For example, you need only type ch for the change command.
Detailed descriptions of commands
change Allow user to provide the necessary information prior to
submitting an APR. There are 2 kinds of input here. First,
information that is extracted from the system the user is on.
Second, information that the user must input. Most field
defaults (including system extractable data) will be
overridable by the user. The date field is the only non-
overridable field. A file exists between sessions which
currently stores customer contact, name, address, and telephone
information. This file is created upon the first invocation of
the mkapr tool, is stored in the current working directory and
is called .aprinit. Upon subsequent invocations of the mkapr
tool, the customer information is used as the default for these
fields.
Within the change command, the prompt becomes mkapr..change>
Current input is then displayed by field. The user is asked to
enter the field # to change, then asked to enter the changed
value (entering <RETURN> effectively will abort the current
change field # request leaving the field unchanged). The cycle
is then repeated. Replying 'h' or 'help' at this point will
display the following help message for the change command:
Change Command Description
help [mkapr] List commands. To display the help file, use
the mkapr option.
display fields Display all fields and their respective
values.
change field n Request to change the value of field # n.
Pressing the RETURN key at the prompt
enter new value ==>
will leave the value unchanged.
exit Exit the change command.
edit An appropriate editor will be invoked according to available
system services. The user should enter a detailed problem
description and save and exit the editor in the appropriate
manner. You will then be returned to the mkapr> prompt.
view The current mkapr information will be displayed to the user in
an appropriate manner according to available system services.
print The current mkapr information will be printed to the default
printer according to available system services.
send The current mkapr information will be sent to Apollo Computer
in an appropriate manner according to available system
services.
exit If any changes to customer information occurred during this
session, save all customer information to the non-system
cancel Exit mkapr. Do not save changes to customer information from
this session.
INITIAL FIELD VALUES
The fields of an Apollo Problem Report that are collectively known as
customer information Fields are initialized from a file read when mkapr
starts up. These fields contain such information as the name of the
customer contact, the name (company name) of the customer, and the
customer's address and telephone number. The initialization file has the
name .aprinit and the mkapr program will search for it. The search order
for the initialization file is:
1. Look in the current working directory
2. Look in the home directory as given by the shell variable HOME
3. Look in the system directory /etc/apr
It is not an error for no initialization file to exist; mkapr will leave
the customer information fields blank. The fields can be edited and the
initialization file will be updated when mkapr exits.
The file /etc/apr/.aprinit is a special case; mkapr will not write to
this file. The system administrator (or other privileged account) must
create the directory /etc/apr with appropriate access permissions, then
run mkapr to create a local copy of the file .aprinit and copy or move
the file to the directory.
The initialization file is an ASCII text file that may be created and
modified using any of the text editors available to you. The body of the
.aprinit file created by mkapr is reproduced here:
# Comment lines begin with '#'
# Non-comment lines have the following form:
# FIELD_NAME : FIELD_VALUE : IGNORED
# The field name must not be changed.
# The ':' character delimits fields.
# The field value may be changed; it must not contain ':'.
# unless the field value is quoted by either ' ' or " " pairs.
# Anything after the second ':' is thrown away.
#
customer_contact : A. Random User : 14
customer_name : Apollo Computer, Inc. : 21
customer_addr1 : CHF 02 RD : 9
customer_addr2 : 330 Billerica Road : 18
customer_addr3 : Chelmsford, MA 01824 : 21
customer_addr4 : USA : 3
customer_phone : 1-508-256-6600 x7739 : 20
mail_path : 'apollo!apr_cs_admin:' : 22
#
NOTES
Since mkapr assumes that the site mail facility (probably sendmail) knows
how to get from your site to Apollo, you must edit the mail_path field
value in .aprinit to give mkapr the correct path. Be sure that your
mail facility is setup correctly. See your site administrator for help.
Run /usr/ucb/newaliases at least once before attempting to use mkapr's
send function.
Offsite mailing may not be allowed by your site. If so, you must make
other arrangements to get mail to Apollo. See your site administrator
for help.
FILES
/usr/apollo/bin/mkapr The executable object
/usr/man/cat1/mkapr.1 This manual page (UNIX)
/sys/help/mkapr.hlp This help file (AEGIS)
Initial field values (search order):
.aprinit (1st) (updated)
$HOME/.aprinit (2nd) (updated)
/etc/apr/.aprinit (last) (read only)
/tmp/apr.* Temporary files:
apr.*.v Product report view file
apr.*.p Product report print file
apr.*.s Product report send file
apr.*.c Product report send command file
apr.*.e Problem description edit file