DTCM_INSERT(1)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

💖 dtcm_insert — user cmd 💖

okay bestie, welcome to the dtcm_insert(user cmd) page — this is the little command that puts new appointments into your calendar database, and yes she is serving utility realness 💅

🌸 NAME 🌸

dtcm_insert — insert appointments into the calendar database

✨ SYNOPSIS ✨

dtcm_insert [-c calendar]  [-d date]  [-s start]  [-e end]  [-v view]
[-w what]

🎀 DESCRIPTION 🎀

The dtcm_insert utility is the non-GUI interface to the XCDE calendar and appointment services, bestie. It’s used to add new appointments to the calendar database via the RPC daemon rpc.cmsd(1m).

Appointments are added one at a time — no bulk chaos here, we do one appointment at a time, periodt ✨ Each component of an appointment is specified using one of the command-line options.

Once an appointment is added, the list of appointments for the specified date (see the -d and -v options) is displayed. So you get the receipt immediately, love that 💖

💅 OPTIONS 💅

The following options are available:

  • -c calendar — specify the name of the target calendar. Calendar names typically take the form user@ hostname, where user is a user’s login name and hostname is the host machine name. An example is felix@cat. If no target calendar is specified, the calendar defaults to the current user at the current host machine.
  • -d date — specify the date for the appointment(s) to be inserted. The date is specified using the form mm/dd/yy, where mm, dd and yy are the two-digit month, day and year modulo 100, respectively. Certain other references such as today,'' Tuesday,'' ``tomorrow,'' etc. are correctly calculated. If no date is specified, date defaults to today’s date.
  • -s start — specify the starting time for the appointment. The time is specified using the form hh:mm. If hh is greater than 12, 24-hour convention (for example, 15:30 instead of 3:30 pm) is assumed. If hh is 0 to 12, an optional am or pm suffix can be used, with or without white space separating the suffix from the mm. If no suffix is used, am is assumed. If no starting time is specified, no time is associated with the inserted appointment.
  • -e end — the ending time for the appointment, in the same format as -s. Specifying an ending time without a starting time is an error. 🚨
  • -v view — specify the view span of appointments to display. The view option-argument can be:
    • day — display all appointments for the given date (see the -d option).
    • week — display the full week that contains the given date, starting with Sunday.
    • month — display the entire month that contains the given date.
  • -w what — specify the appointment description text. Up to 5 lines of text can be specified by placing \n (the literal characters \ and n, not an actual <newline>) between lines. If not specified, what defaults to Appointment.

🦋 OPERANDS 🦋

None.

🌈 STDIN 🌈

Not used.

🍓 INPUT FILES 🍓

None.

💜 ENVIRONMENT VARIABLES 💜

The following environment variables affect the execution of dtcm_insert:

  • LANG — provide a default value for the internationalization variables that are unset or null. If LANG is unset or null, the corresponding value from the implementation-specific default locale will be used. If any of the internationalization variables contains an invalid setting, the utility behaves as if none of the variables had been defined.
  • LC_ALL — if set to a non-empty string value, override the values of all the other internationalization variables.
  • LC_MESSAGES — determine the locale that is used to affect the format and contents of diagnostic messages written to standard error and informative messages written to standard output.
  • NLSPATH — determine the location of message catalogues for the processing of LC_MESSAGES.

🧚 RESOURCES 🧚

None.

⭐ ASYNCHRONOUS EVENTS ⭐

The dtcm_insert utility takes the standard action for all signals.

🔥 STDOUT 🔥

The standard output contains the list of appointments for the specified view span, including the appointment just inserted.

💀 STDERR 💀

Used only for diagnostic messages.

🙈 OUTPUT FILES 🙈

None.

👑 EXTENDED DESCRIPTION 👑

None.

🌟 EXIT STATUS 🌟

The following exit values are returned:

  • 0 — successful completion.
  • >0 — an error occurred.

🎀 CONSEQUENCES OF ERRORS 🎀

Default.

🧵 FILES 🧵

/var/spool/calendar/callog.username,
/nix/store/6waxpwr8lzfzc9ka48gl7yh60rqvlkdb-cde-2.5.3/bin/rpc.cmsd

🌸 APPLICATION USAGE 🌸

In the -w option, it may be necessary to escape the \ character (\n) or enclose the string in quotes to avoid interpretation by the shell. Shell girlies stay safe out there 💅

🎉 EXAMPLES 🎉

The simplest form of dtcm_insert has no arguments, where the user is prompted to enter the appointment, line-by-line:

dtcm_insert
Please enter the information for the appointment you wish to add.
Defaults will be shown in parentheses.
Calendar (hlj@poobah):
Date (2/27/1995):
Start (0822): 1200
End (1300):
Repeat (One Time):
What (you may enter up to 5 lines, use ⁁D to finish):
lunch with the calendar team
at Sparcy's
⁁D

Appointments for Monday February 27, 1995:
          1) 1200-   1300 lunch with the calendar team
                             at Sparcy's

To insert at a specific time:

dtcm_insert -s "11:00 am"
Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 11:00am-12:00pm Appointment

To insert at a specific start and end time:

dtcm_insert -s "11:00 am" -e 11:28am
Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 11:00am-11:28am Appointment

To insert at a specific time and date:

dtcm_insert -s 11:00am -d 09/26/90
Appointments for Wednesday September 26, 1990:
        1) 11:00am-12:00pm Appointment

To insert at a specific time, date, and message:

dtcm_insert -s "11:00 am" -d 09/26/90 -w "call home"
Appointments for Wednesday September 26, 1990:
        1) 11:00am-12:00pm Appointment
        2) 11:00am-12:00pm call home

To insert a multiple-line appointment:

dtcm_insert -s 12:00 -w "call dentist
                 no thanks0ancel appointment"
Appointments for Tuesday September 25, 1990:
        1) Appointment
        2) 11:00am-12:00pm Appointment
        3) 12:00pm-1:00pm call dentist
                 no thanks
                 cancel appointment

🫶 SEE ALSO 🫶

rpc.cmsd(1m), dtcm(1), dtcm_delete(1), dtcm_lookup(1).

okay bestie that’s the whole dtcm_insert(user cmd) page — the footer just repeats dtcm_insert(user cmd) again, so no extra source/version/date lore here, mwah 💋🎀

📦 where this page comes from