Tag: linux

How do I cancel faxes in the VSIFAX queue?

Many times it’s quicker to cancel faxes from the VSI-FAX queue in AIX, Linux or Windows instead of from the Eclipse outgoing fax status queue.

To cancel all faxes for a certain user (for example, johndoe):

vfxcancel -u johndoe "*"

To locate the job number and cancel a single fax (for example, job number 1234):

vfxstat
vfxcancel 1234
For more information on the many VSIFAX administration command functions, see the VSI-FAX Reference Addendum.

How to Purge the Outgoing Fax Queue

If the outgoing fax queue has old and/or stale information, it may be necessary to purge this queue.  To do this, open two separate sessions: one Eterm session logged into the Eclipse application, and an SSH root session. This is an advanced procedure, so proceed at your own risk or call Eclipse for assistance. This should be done after all valid faxes have gone out as it will clear EVERYTHING in the outgoing queue.

From Eterm’s main menu, press F2 -> T (TCL)
At the ; prompt, type in this command:

;clear.file.real fax.queue

After you hit ENTER, the session will most likely hang for a while, because there will be a lock on the file. Now, from the root session, find the Process ID for FAX.FEEDBACK3 with this command:

ps -ef | grep FAX

The Process ID (PID) will be the first set of number on the line with FAX.FEEDBACK3. For example:

[root@eclipse enp]# ps -ef | grep FAX
eclipseB  7248 29271  0 11:32 ?        00:00:01 phantom PHW FAX.FEEDBACK3
root     11469  7149  0 11:57 pts/2    00:00:00 grep FAX

Kill that process with this command:

kill -4 7248

The outgoing fax queue should now be clear and the fax feedback phantom should automatically start within 1 minute.

Type “exit” to close the root session and hit “ESC” to exit the TCL screen.

How do I modify my Linux tape backup script to send its logs via email?

It’s prudent to make a backup copy before editing system files. This prevents having to restore a file from tape, and allows you to track changes.
    • Log in as root
    • Open the backup script for editing:
vim /u2/UTILS/bin/snapsave.cfg
    • Find the MAILLIST value, and add any additional email addresses, separated by commas, like so:
MAILLST='root,itadmin@mycompany.com'
  • Save and quit

Related: How do I forward root’s mail to another address?

How does an Eclipse user change their OS password using Eterm?

View a step-by-step screencast of this process:

If you need to change your Eclipse user’s OS password (the one entered at the “white” Eterm login screen):

  • Log into Eterm
  • Select F2-System
  • Select TCL
  • At the TCL prompt (; semicolon), type sh and hit ENTER
  • At the user’s shell prompt ($ dollar sign), type passwd and hit ENTER
  • Follow the prompts to set your new password
  • When finished, type exit to exit the shell.
  • Hit ESC to exit TCL mode
If your new password is not being accepted, you may be violating your company’s password policy by attempting to set a password that is too short or based on a dictionary word. You will need to contact your system administrator to set your password or relax the password restrictions. If you would like your Eterm users to have no OS password, please see How do I set a blank user password in Linux?

How do I add or change a VSI-FAX modem?

Identifying the Serial Port

Before adding or changing a modem, verify the port name.

On Linux, you can typically get a list of serial ports using:

ls -l /dev/tty*

On AIX, you can get a list of the serial ports using:

lsdev -Cc tty

Once you have identified the appropriate serial port, you may continue with adding or changing the modem(s) in VSI-FAX.

If you are having difficulty identifying the serial port device name(s), please refer to the manufacturer’s documentation or contact your support provider.

Adding a New Modem

To add a modem, use the following command, where /dev/ttyACM1 is the new modem’s serial port, modem2 is the name we’d like to give the VSI-FAX modem, and fax1 is the name of the VSI-FAX modem pool and Eclipse fax device:

vfxadmin device -a -d -v /dev/ttyACM1 modem2
vfxadmin class -d -a modem2 fax1

To verify that the change is in place:

vfxstat -a

Modifying an Existing Modem

To change a modem’s port on either Linux or AIX, use the following command (where /dev/ttyD00 is the existing modem’s new serial port, and modem1 is the name of the VSI-FAX modem you’re updating):

vfxadmin device -u -v /dev/ttyD00 modem1

To verify that the change is in place:

vfxstat -a